Translation Flow is an advanced translation workflow system specifically designed for long documents (.docx). By leveraging Multi-Agent collaboration, Style Restoration technology, and LLM-as-a-Judge (automated quality assessment), it provides precision and formatting retention far beyond traditional translation software.
The central hub for your translation project. View and manage original paragraphs, compare multiple AI translations, and monitor the status of your translators and judgers in real-time.
Flexibly configure multiple translation agents to deliver personalized results based on different audiences and styles.
Introduce "Judge" agents to automatically compare multiple translation versions and select the best result based on fidelity and naturalness.
Automatically identify and extract specialized terminology and named entities to ensure consistency across the entire document.
- 📄 Deep Style Restoration (WordFlux Technology): Translates text while precisely re-aligning original formatting like bold, italic, and underline using LLM-powered tag alignment.
- 🧠 Intelligent Context Awareness: Uses a sliding window technique to include preceding context during translation, solving the "fragmentation" issue common in long document processing.
- 🔍 Automated NER Extraction: Concurrent extraction of names, locations, organizations, and technical terms to build a project-specific glossary.
- 🎭 Customizable Translator Fleet: Deeply customize translations for specific "Audiences" (e.g., General, Technical, Academic) and "Styles" (e.g., Storytelling, Formal, Business).
- 👨⚖️ AI Judger (LLM-as-a-Judge): Scores versions based on Fidelity, Consistency, and Naturalness, providing detailed reasoning for each selection.
- ⚡ High-Performance Virtualized UI: Powered by React-Virtuoso to handle documents with tens of thousands of paragraphs smoothly.
- 💾 Versatile Export Options: Export as plain text (.txt) or fully formatted Word documents (.docx).
- Navigate to the backend directory:
cd backend - Install dependencies (recommended using
uv):uv sync
- Start the development server:
uv run fastapi dev src/main.py --port 8000
- Navigate to the frontend directory:
cd frontend - Install dependencies:
npm install
- Start the development environment:
npm run dev
Visit http://localhost:3000 to get started.
- Backend:
- FastAPI: High-performance asynchronous API framework.
- Marvin AI: Core for building structured agents and workflows.
- SQLAlchemy: Asynchronous Database ORM.
- python-docx: Word document parsing and generation.
- Frontend:
- Next.js: React framework for routing and rendering.
- Tailwind CSS: Modern utility-first CSS framework.
- Lucide React: Beautiful icon set.
- React-Virtuoso: Virtualized list component for performance.
We welcome contributions from the community! Whether you are fixing bugs, adding new features, or improving documentation, your help is much appreciated.
- Fork the Repository: Feel free to fork the project and experiment with your own ideas.
- Submit a Pull Request: If you have a fix or a feature, please submit a PR! Ensure your code follows the existing style and includes relevant tests.
- Report Issues: Found a bug? Open an issue and let us know.
This project is licensed under the MIT License. See the LICENSE file for details.
Crafted with ❤️ by the ider