TelePress
语言 / Language: 中文 · English
向 Telegraph 发布文本、图片与档案的 Python 库与 CLI。
TelePress 把 Markdown、纯文本、图片和富媒体内容发布为 Telegraph 页面， 不关心内容来自哪个平台。
- 纯文本 / Markdown：约 20,000 字符源文本为一页目标自动分页，保留段落边界，并生成上一页、下一页导航
- 图片 / ZIP 图集：超限图片使用 libvips 按需压缩后发布为 Telegra.ph 相册（GIF 保持原样）
- 富媒体（REST）：通过
/publish/rich-novel发布 Markdown + 本地图 - 图片可在「上传图床」与「通用 CDN 代理」两条路径间选择
安装
pip install telepress
# 可选：REST API 服务
pip install "telepress[api]"
# 可选：S3 / R2 / OSS / MinIO 等 S3 兼容图床
pip install "telepress[s3]"
# 可选：YAML 配置
pip install "telepress[yaml]"
30 秒快速开始
pip install telepress
telepress article.md --title "我的文章"
# 或者显式子命令
telepress publish article.md --title "我的文章"
发布图片 / ZIP 图集前先配置一个图床：
telepress configure
telepress check
telepress photo.jpg --title "照片"
telepress gallery.zip --title "图集"
需要服务化时：
pip install "telepress[api]"
telepress-server --host 127.0.0.1 --port 8000
# OpenAPI 交互文档：http://127.0.0.1:8000/docs
运行时首次使用会自动创建并保存 Telegraph token（默认 ~/.telegraph_token）。
文档
README 不是全量文档；稳定契约放在 docs/：
- 快速开始与配置：getting-started.md · configuration.md
- REST API：docs/api/README.md
- 图片与媒体：docs/media/README.md
- Python API / CLI：python-api.md · cli.md
- 架构：architecture/publishing-plane.md
- 运维与当前状态：operations/current-state.md
License
致谢
TelePress 建立在这些项目之上：
- Python-Markdown：Markdown 解析与扩展。
- Pillow：图集与兼容格式处理。
- libvips / pyvips：大图片按需读取、缩放与有界 JPEG/WebP 压缩。
- requests：HTTP 客户端。
- telegraph（python-telegram-bot 团队的 Telegraph 封装）：Telegraph 页面发布。
- 可选 REST 发布层：FastAPI · Uvicorn。
接口与规范参考：Telegraph API。
2 maintainers
Metadata
2 maintainers
Release files for telepress 0.17.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| telepress-0.17.0.tar.gz | 126.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| telepress-0.17.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 181.4 kB
Release files / telepress-0.17.0.tar.gz
| Download URL | telepress-0.17.0.tar.gz |
|---|---|
| Size | 126.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
fe7630b72c7c839864e6d4e0c282a74c4d61e63571f3204f4e93c40b3501d943
|
|
BLAKE2b-256 checksum How to use checksums |
507d04d4b0f93e7c093b5a8216c2bf8dff5a3efa9b5f46356ab94e0d0317a071
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 4, 2026.
Transparency logRelease files / telepress-0.17.0-py3-none-any.whl
| Download URL | telepress-0.17.0-py3-none-any.whl |
|---|---|
| Size | 54.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6e31d74dfaf716b3ad32387c6e9279ee90893927c2d83a12519d2a9962246212
|
|
BLAKE2b-256 checksum How to use checksums |
e7e21c350e1d8380e1a97463baa9ff7c60365f727f3b726fb6438b164eff9f18
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 4, 2026.
Transparency log
