Skip to content

heyifan142857/subbake

Repository files navigation

subbake

PyPI version Python versions CI License

subbake 是一个简单的字幕翻译 CLI,默认将字幕翻译为中文,也可以通过 --target-language en 这类参数切到其他常用语言。

它的目标是用尽量直接的命令行工作流处理字幕翻译,同时保留对批量翻译、断点续跑、缓存和复审这些实用能力的支持。

subbake CLI demo

核心能力

  • 支持 .srt.vtt 和按行处理的 .txt
  • 支持常用目标语言缩写,如 zhenja
  • 智能批量翻译、上下文记忆和 --fast 快速模式
  • glossary、cache、translation memory、断点续跑
  • 高风险 batch 定向复审与失败样本落盘
  • subbake.toml 配置文件和多 profile 模型配置
  • 基于 rich 的命令行可视化,包括进度、时间线和 Token 用量

快速开始

安装并运行:

pip install subbake
sbake translate input.srt --provider openai --model your-model

使用 OpenAI 兼容接口时:

export OPENAI_API_KEY="your_api_key"
export OPENAI_BASE_URL="https://your-provider.example.com/v1"

Gemini 使用:

export GEMINI_API_KEY="your_api_key"
sbake translate input.srt --provider gemini --model gemini-2.5-flash

Anthropic 使用:

export ANTHROPIC_API_KEY="your_api_key"
sbake translate input.srt --provider anthropic --model your-model

内置 mock 后端可用于本地联调:

sbake translate input.srt --provider mock

翻译到其他目标语言:

sbake translate input.srt --provider openai --model your-model --target-language en

配置文件示例见 examples/subbake.toml

文档

文档与使用说明见 项目 Wiki

完整命令说明仍可直接查看:

sbake translate --help
sbake check-key --help
sbake clean --help

About

subbake is a Python CLI for translating subtitle files with LLM backends.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages