How viswaags/translatorai works
AI Translator is a local-first browser application backed by a FastAPI service. Users submit text, images, or audio; the corresponding route detects or extracts input, then may translate it and optionally synthesize speech. The README documents these workflows and the browser-to-API boundary. Source excerpts show OCR orchestration and shared lazy service registration; the translation implementation and most frontend internals were not sampled, so those details are represented only where documented or indexed.
Main entry points: registry.py Service registry · main.py FastAPI app · ocr.py Image workflow · speech.py Speech workflow
Components 19
Browser interface
- Browser client
frontend/js/api.js
API workflows
- FastAPI app
backend/ai_translator_api/main.py - Text workflow
backend/ai_translator_api/api/routes/text.py - Image workflow
backend/ai_translator_api/api/routes/ocr.py - Speech workflow
backend/ai_translator_api/api/routes/speech.py - Health status
backend/ai_translator_api/api/routes/health.py - API contracts
backend/ai_translator_api/models/schemas.py
Inference services
- IndicTrans2 translation
backend/ai_translator_api/services/translation/translation_service.py - PaddleOCR extraction
backend/ai_translator_api/services/ocr/ocr_service.py - Whisper transcription
backend/ai_translator_api/services/stt/stt_service.py - Piper synthesis
backend/ai_translator_api/services/tts/tts_service.py - Language detection
backend/ai_translator_api/utils/language_detector.py
Shared platform
- Language catalog
backend/ai_translator_api/utils/languages.py - Upload handling
backend/ai_translator_api/utils/uploads.py - Service registry
backend/ai_translator_api/core/registry.py - Artifact readiness
backend/ai_translator_api/core/readiness.py - Runtime configuration
backend/ai_translator_api/core/config.py - Error handling
backend/ai_translator_api/api/error_handlers.py
Other components
- User
Connections 44
- User → Browser client: uses
README.md - Browser client → FastAPI app: sends HTTP requests
README.md - FastAPI app → Text workflow: routes to
backend/ai_translator_api/main.py - FastAPI app → Image workflow: routes to
backend/ai_translator_api/main.py - FastAPI app → Speech workflow: routes to
backend/ai_translator_api/main.py - FastAPI app → Health status: routes to
backend/ai_translator_api/main.py - FastAPI app → Service registry: initializes
backend/ai_translator_api/main.py - FastAPI app → Artifact readiness: checks artifacts
backend/ai_translator_api/main.py - FastAPI app → Error handling: registers handlers
backend/ai_translator_api/main.py - Text workflow → Service registry: gets services
backend/ai_translator_api/api/routes/text.py - Text workflow → Language detection: detects language
backend/ai_translator_api/api/routes/text.py - Text workflow → IndicTrans2 translation: translates text
README.md - Text workflow → Piper synthesis: optionally synthesizes
README.md - Image workflow → Upload handling: manages image upload
backend/ai_translator_api/api/routes/ocr.py - Image workflow → Service registry: gets services
backend/ai_translator_api/api/routes/ocr.py - Image workflow → PaddleOCR extraction: extracts text
backend/ai_translator_api/api/routes/ocr.py - Image workflow → IndicTrans2 translation: translates extraction
backend/ai_translator_api/api/routes/ocr.py - Image workflow → Piper synthesis: optionally synthesizes
backend/ai_translator_api/api/routes/ocr.py - Image workflow → Language detection: detects language
backend/ai_translator_api/api/routes/ocr.py - Speech workflow → Upload handling: manages audio upload
backend/ai_translator_api/api/routes/speech.py - Speech workflow → Service registry: gets services
backend/ai_translator_api/api/routes/speech.py - Speech workflow → Whisper transcription: transcribes audio
README.md - Speech workflow → IndicTrans2 translation: translates transcript
README.md - Speech workflow → Piper synthesis: optionally synthesizes
README.md - Health status → Artifact readiness: reports readiness
backend/ai_translator_api/api/routes/health.py - Health status → Language catalog: lists languages
backend/ai_translator_api/api/routes/health.py - Service registry → IndicTrans2 translation: creates lazily
backend/ai_translator_api/core/registry.py - Service registry → PaddleOCR extraction: creates lazily
backend/ai_translator_api/core/registry.py - Service registry → Whisper transcription: creates lazily
backend/ai_translator_api/core/registry.py - Service registry → Piper synthesis: creates lazily
backend/ai_translator_api/core/registry.py - Service registry → Language detection: creates lazily
backend/ai_translator_api/core/registry.py - Artifact readiness → Runtime configuration: reads settings
backend/ai_translator_api/core/readiness.py - Artifact readiness → Language catalog: checks supported artifacts
backend/ai_translator_api/core/readiness.py - PaddleOCR extraction → Runtime configuration: uses settings
backend/ai_translator_api/services/ocr/ocr_service.py - PaddleOCR extraction → Language catalog: uses language metadata
backend/ai_translator_api/services/ocr/ocr_service.py - PaddleOCR extraction → Language detection: detects language
backend/ai_translator_api/services/ocr/ocr_service.py - Whisper transcription → Runtime configuration: uses settings
backend/ai_translator_api/services/stt/stt_service.py - Whisper transcription → Language catalog: maps recognized languages
backend/ai_translator_api/services/stt/stt_service.py - Piper synthesis → Runtime configuration: uses settings
backend/ai_translator_api/services/tts/tts_service.py - Piper synthesis → Language catalog: uses language metadata
backend/ai_translator_api/services/tts/tts_service.py - Text workflow → API contracts: validates requests
backend/ai_translator_api/api/routes/text.py - Image workflow → API contracts: validates requests
backend/ai_translator_api/api/routes/ocr.py - Speech workflow → API contracts: validates requests
backend/ai_translator_api/api/routes/speech.py - Health status → API contracts: formats status
backend/ai_translator_api/api/routes/health.py