{"id":22703792,"url":"https://github.com/kazkozdev/book-translator","last_synced_at":"2025-04-23T00:13:22.685Z","repository":{"id":266328414,"uuid":"897986432","full_name":"KazKozDev/book-translator","owner":"KazKozDev","description":"📖 A blazing tool for book translations, powered by local LLM. Translates your books and documents with impressive quality using a unique two-stage approach.","archived":false,"fork":false,"pushed_at":"2025-03-29T19:50:23.000Z","size":537,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-23T00:13:02.564Z","etag":null,"topics":["google-translate","google-translate-api","llm","ollama-api","translation","translation-service","translations"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/KazKozDev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-03T15:32:33.000Z","updated_at":"2025-04-15T22:12:19.000Z","dependencies_parsed_at":"2024-12-03T18:39:45.724Z","dependency_job_id":"b21da370-e810-4a70-8016-d0eb09ca6300","html_url":"https://github.com/KazKozDev/book-translator","commit_stats":null,"previous_names":["kazkozdev/book-translator"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KazKozDev%2Fbook-translator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KazKozDev%2Fbook-translator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KazKozDev%2Fbook-translator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KazKozDev%2Fbook-translator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KazKozDev","download_url":"https://codeload.github.com/KazKozDev/book-translator/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250343956,"owners_count":21415041,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["google-translate","google-translate-api","llm","ollama-api","translation","translation-service","translations"],"created_at":"2024-12-10T08:12:41.956Z","updated_at":"2025-04-23T00:13:22.656Z","avatar_url":"https://github.com/KazKozDev.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/f62278a1-ec33-4096-aa13-a855dd7bda4f\" alt=\"Logo\"\u003e\n  \u003cbr\u003e \n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n\u003cp\u003e\u003cstrong\u003eBook Translator\u003c/strong\u003e\u003c/p\u003e\n  \u003cp\u003eA platform for translating books and large text documents.\u003c/p\u003e\n  \u003cp\u003e\u003cstrong\u003eTwo-step process. For better quality.\u003c/strong\u003e\u003c/p\u003e\n\u003c/div\u003e\n  \u003cp\u003eThe tool processes text files using Google Translate and Ollama LLM models. It combines primary machine translation with literary refinement for better results. Suitable for translators, publishers, authors, researchers and content creators who need to translate large text documents.\u003c/p\u003e\nSupport for multiple languages including English, Russian, German, French, Spanish, Italian, Chinese, and Japanese, real-time translation progress tracking for both stages, translation history and status monitoring, automatic error recovery and retry mechanisms, and real-time metrics and system monitoring.  \u003cbr\u003e   \u003cbr\u003e \n\n![Book Translator Demo](https://raw.githubusercontent.com/KazKozDev/book-translator/main/demo.jpg)\n\nThe application uses a sophisticated two-stage translation approach:\n\n### Stage 1: Initial Translation\n- Uses Google Translate API for fast initial translation\n- Handles large volumes of text efficiently\n- Provides basic translation quality\n- Progress tracking for initial translation stage\n\n### Stage 2: Literary Refinement\n- Uses Ollama LLM models to refine the initial translation\n- Improves literary quality and natural language flow\n- Maintains context and style\n- Separate progress tracking for refinement stage\n\n### Prerequisites\n\n- Python 3.7+\n- [Ollama](https://ollama.ai/) installed and running\n- Node.js (for development)\n\n### Quick Start\n\n1. **Clone the repository**\n```bash\ngit clone https://github.com/kazkozdev/book-translator.git\ncd book-translator\n```\n\n2. **Install dependencies**\n```bash\npip install -r requirements.txt\n```\n\n3. **Pull required Ollama model**\n```bash\nollama pull gemma2:27b\n```\n\n4. **Start the application**\n```bash\npython translator.py\n```\n\n5. **Access the application**\n- Open `http://localhost:5001` in your browser\n\n### Architecture\n\n```\nbook-translator/\n├── translator.py        # Flask backend\n├── static/             # Frontend files\n├── uploads/            # Temporary uploads\n├── translations/       # Completed translations\n├── logs/              # Application logs\n├── translations.db     # Main database\n└── cache.db           # Cache database\n```\n\n### License\n\nMIT License - see [LICENSE](LICENSE)\n\n---\nIf you like this project, please give it a star ⭐\n\nFor questions, feedback, or support, reach out to:\n\n[Artem KK](https://www.linkedin.com/in/kazkozdev/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkazkozdev%2Fbook-translator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkazkozdev%2Fbook-translator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkazkozdev%2Fbook-translator/lists"}