fanyit 0.2.0

Translate subtitles and documents from your terminal

fanyit

Install. Translate. Done.

Zero-config CLI tool for translating subtitles and documents. Works out of the box with no API keys or setup required.

Install

pip install fanyit

Quick Start

Translate a subtitle file - no engine flag needed:

fanyi subs movie.srt --target zh

That's it. Fanyi automatically finds a working translation engine or uses its built-in demo engine.

For real translations, run setup once:

fanyi setup

Quality Tiers

Choose your speed/quality tradeoff:

fanyi subs movie.srt --target zh --quality fast      # Draft quality, maximum speed
fanyi subs movie.srt --target zh --quality standard  # Everyday use (default)
fanyi subs movie.srt --target zh --quality best      # Publication quality, slower

Supported Formats

Format	Extensions	Description
SRT	.srt	SubRip subtitle format
ASS/SSA	.ass, .ssa	Advanced SubStation Alpha
VTT	.vtt	WebVTT subtitle format
Text	.txt	Plain text files
Markdown	.md	Markdown documents
PDF	.pdf	PDF documents (text extraction)
DOCX	.docx	Microsoft Word documents
Audio	.mp3, .wav	Audio transcription + translation

Advanced

Configuration File

Create ~/.fanyi.yaml or run fanyi setup:

engine: ollama
target_language: zh
ollama_host: http://localhost:11434
ollama_model: llama3

Environment Variables

export FANYI_ENGINE=openai
export FANYI_OPENAI_API_KEY=your-key
export FANYI_TARGET_LANGUAGE=zh

All Engines

Engine	Description	Requires API Key
OpenAI	GPT-based translation	Yes
DeepL	Professional translation API	Yes
Ollama	Local LLM (private, offline)	No
Mock	Built-in demo engine	No

All CLI Options

fanyi translate file.txt --engine openai --target zh --source en
fanyi translate file.txt --quality best --context-lines 5
fanyi translate ./docs/ --recursive --concurrency 4
fanyi translate file.txt --no-cache --resume --glossary terms.csv
fanyi subs movie.srt --target ja --quality fast
fanyi check          # Verify engine connectivity
fanyi config --show  # View current config
fanyi cache stats    # Cache statistics
fanyi jobs list      # View interrupted jobs

License

MIT