writing-translator 0.1.0

Console AI agent for translating Chinese academic writing into polished English.

writing-translator

用 AI 实现中文到英文学术写作的翻译、润色、逻辑检查和降 AI 味处理。

Setup

Create a local virtual environment and install dependencies with uv:

uv venv
uv sync --extra dev

You can also install the package with pip:

pip install .

After installation, the writing-translator command is available in the active Python environment.

Copy the example config and fill in your API information:

writing-translator --init-config --config config.toml

config.toml is ignored by git. You can either set api_key directly in that file for local use, or keep api_key_env = "OPENAI_API_KEY" and export the key:

export OPENAI_API_KEY="your-api-key"

For OpenAI-compatible providers, set base_url in config.toml.

Run

uv run writing-translator --config config.toml

If you installed with pip, run:

writing-translator --config config.toml

Paste Chinese text into the console. Submit an empty line to run the pipeline. Type :q to exit.

The agent prints three stages:

• Translation: first English LaTeX translation from zh2en.md
• Polished: academic editing result from finetune.md
• Final: naturalized, lower-AI-flavor English result from noai.md

logic_check.md runs between Polished and Final; its report is used as a correction signal for the final rewrite.