https://github.com/leynier/doculingo
A command-line tool to translate large documents using language models. It preserves the file formatting and simplifies migrating documentation to other languages.
https://github.com/leynier/doculingo
cli document-translation docx github-actions gpt openai openai-api pypi python translation typer
Last synced: about 2 months ago
JSON representation
A command-line tool to translate large documents using language models. It preserves the file formatting and simplifies migrating documentation to other languages.
- Host: GitHub
- URL: https://github.com/leynier/doculingo
- Owner: leynier
- License: mit
- Created: 2024-06-05T10:02:47.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-08T05:23:18.000Z (4 months ago)
- Last Synced: 2025-07-22T00:56:53.639Z (3 months ago)
- Topics: cli, document-translation, docx, github-actions, gpt, openai, openai-api, pypi, python, translation, typer
- Language: Python
- Homepage: https://pypi.org/project/doculingo
- Size: 143 KB
- Stars: 3
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- License: license
Awesome Lists containing this project
README
# DocuLingo
[](https://opensource.org/licenses/MIT)
[](https://pypi.org/project/doculingo)
[](https://github.com/leynier/doculingo/commits)
[](https://github.com/leynier/doculingo/commits)
[](https://github.com/leynier/doculingo/stargazers)
[](https://github.com/leynier/doculingo/network/members)
[](https://github.com/leynier/doculingo)
[](https://github.com/leynier/doculingo/graphs/contributors)
A **command-line tool** to translate large documents using language models. It preserves the file formatting and simplifies migrating documentation to other languages.
---
## Table of Contents
* [Overview](#overview)
* [Key Features](#key-features)
* [Installation](#installation)
* [Quick Start](#quick-start)
* [CLI Reference](#cli-reference)
* [Development](#development)
* [Environment Variables](#environment-variables)
* [License](#license)
---
## Overview
`doculingo` helps you translate documents while preserving their formatting. It currently works with Word files and aims to support additional formats in the future, making it ideal for projects that require multiple language versions without losing the original layout.
---
## Key Features
* ✨ **Automatic Translation** — uses OpenAI to safely translate paragraphs.
* 📝 **Preserves Styles** — copies fonts, colors, and alignment to the translated version.
* 📄 **Document Support** — currently handles large `.docx` files with more formats planned.
* 🔁 **Automatic Retries** — retries when the API fails.
* ⚙️ **Simple CLI** — clear commands with built-in help.
---
## Installation
Run instantly with [uv](https://github.com/astral-sh/uv) without installing:
```bash
uvx doculingo --help
```
Or install from PyPI:
```bash
pip install doculingo
```
---
## Quick Start
Translate a Word document from Spanish to English:
```bash
doculingo word \
--input file.docx \
--output translated.docx \
--language-source spanish \
--language-target english
```
---
## CLI Reference
Get the full list of options with:
```bash
doculingo --help
```
The main subcommand is `word`, designed for `.docx` files.
---
## Development
Install the dependencies and run the tool locally:
```bash
uv lock
uv sync --all-groups --all-extras
uv run doculingo --help
```
---
## Environment Variables
Copy `.env.example` to `.env` and set `OPENAI_API_KEY` with your OpenAI key.
---
## License
Distributed under the MIT license. See the [`license`](license) file.