A powerful async-first localization engine that supports various content types including plain text, objects, chat sequences, and HTML documents.
- 🚀 Async-first design for high-performance concurrent translations
- 🔀 Concurrent processing for dramatically faster bulk translations
- 🎯 Multiple content types: text, objects, chat messages, and more
- 🌐 Auto-detection of source languages
- ⚡ Fast mode for quick translations
- 🔧 Flexible configuration with progress callbacks
- 📦 Context manager support for proper resource management
The async implementation provides significant performance improvements:
- Concurrent chunk processing for large payloads
- Batch operations for multiple translations
- Parallel API requests instead of sequential ones
- Better resource management with httpx
pip install lingodotdevimportasynciofromlingodotdevimportLingoDotDevEngineasyncdefmain(): # Quick one-off translation (handles context management automatically)result=awaitLingoDotDevEngine.quick_translate( "Hello, world!", api_key="your-api-key", target_locale="es" ) print(result) # "¡Hola, mundo!"asyncio.run(main())importasynciofromlingodotdevimportLingoDotDevEngineasyncdefmain(): config={"api_key": "your-api-key", "api_url": "https://engine.lingo.dev"# Optional, defaults to this } asyncwithLingoDotDevEngine(config) asengine: # Translate texttext_result=awaitengine.localize_text( "Hello, world!",{"target_locale": "es"} ) # Translate object with concurrent processingobj_result=awaitengine.localize_object({"greeting": "Hello", "farewell": "Goodbye", "question": "How are you?" },{"target_locale": "es"}, concurrent=True# Process chunks concurrently for speed ) asyncio.run(main())asyncdefbatch_example(): # Translate to multiple languages at onceresults=awaitLingoDotDevEngine.quick_batch_translate( "Welcome to our application", api_key="your-api-key", target_locales=["es", "fr", "de", "it"] ) # Results: ["Bienvenido...", "Bienvenue...", "Willkommen...", "Benvenuto..."]asyncdefprogress_example(): defprogress_callback(progress, source_chunk, processed_chunk): print(f"Progress: {progress}% - Processed {len(processed_chunk)} items") large_content={f"item_{i}": f"Content {i}"foriinrange(1000)} asyncwithLingoDotDevEngine({"api_key": "your-api-key"}) asengine: result=awaitengine.localize_object( large_content,{"target_locale": "es"}, progress_callback=progress_callback, concurrent=True# Much faster for large objects )asyncdefchat_example(): chat_messages= [{"name": "Alice", "text": "Hello everyone!"},{"name": "Bob", "text": "How is everyone doing?"},{"name": "Charlie", "text": "Great to see you all!"} ] asyncwithLingoDotDevEngine({"api_key": "your-api-key"}) asengine: translated_chat=awaitengine.localize_chat( chat_messages,{"source_locale": "en", "target_locale": "es"} ) # Names preserved, text translatedasyncdefconcurrent_objects_example(): objects= [{"title": "Welcome", "description": "Please sign in"},{"error": "Invalid input", "help": "Check your email"},{"success": "Account created", "next": "Continue to dashboard"} ] asyncwithLingoDotDevEngine({"api_key": "your-api-key"}) asengine: results=awaitengine.batch_localize_objects( objects,{"target_locale": "fr"} ) # All objects translated concurrentlyasyncdefdetection_example(): asyncwithLingoDotDevEngine({"api_key": "your-api-key"}) asengine: detected=awaitengine.recognize_locale("Bonjour le monde") print(detected) # "fr"config={"api_key": "your-api-key", # Required: Your API key"api_url": "https://engine.lingo.dev", # Optional: API endpoint"batch_size": 25, # Optional: Items per batch (1-250)"ideal_batch_item_size": 250# Optional: Target words per batch (1-2500) }- source_locale: Source language code (auto-detected if None)
- target_locale: Target language code (required)
- fast: Enable fast mode for quicker translations
- reference: Reference translations for context
- concurrent: Process chunks concurrently (faster, but no progress callbacks)
- concurrent=True: Enables parallel processing of chunks
- progress_callback: Function to track progress (disabled with concurrent=True)
asyncdeferror_handling_example(): try: asyncwithLingoDotDevEngine({"api_key": "invalid-key"}) asengine: result=awaitengine.localize_text("Hello",{"target_locale": "es"}) exceptValueErrorase: print(f"Invalid request: {e}") exceptRuntimeErrorase: print(f"API error: {e}")- Use
concurrent=Truefor large objects or multiple chunks - Use
batch_localize_objects()for multiple objects - Use context managers for multiple operations
- Use
quick_translate()for one-off translations - Adjust
batch_sizebased on your content structure
The async version is a drop-in replacement with these changes:
- Add
async/awaitto all method calls - Use
async withfor context managers - All methods now return awaitable coroutines
localize_text(text, params)- Translate text stringslocalize_object(obj, params)- Translate dictionary objectslocalize_chat(chat, params)- Translate chat messagesbatch_localize_text(text, params)- Translate to multiple languagesbatch_localize_objects(objects, params)- Translate multiple objectsrecognize_locale(text)- Detect languagewhoami()- Get API account info
quick_translate(content, api_key, target_locale, ...)- One-off translationquick_batch_translate(content, api_key, target_locales, ...)- Batch translation
Apache-2.0 License