How soumyacodes007/alcheanimyst works
Project Type & Purpose
• A Python-based AI tool that converts text prompts into 2D animated videos with sound.
Main Components
• main.py: Entry point, orchestrates the pipeline.
• engine/
• alchymist_ai.py: Core AI logic, prompt→scene planning.
• retry_loop.py: Retry wrapper for transient errors.
• services/
• elevenlabs_service.py: Text-to-speech audio generation.
• video_creation.py: 2D animation and video assembly.
• requirements.txt: Third-party libs (e.g., AI SDKs, video tools).
Relationships & Data Flow
• User input → main.py
• main.py calls alchymist_ai to generate a scene script
• main.py uses retry_loop around external calls
• Audio: call elevenlabs_service → MP3/WAV
• Video: call video_creation → video frames + audio overlay
• Output: final .mp4 file
Architectural Patterns
• Pipeline pattern: sequential stages (AI → TTS → video)
• Modular services: each service is self-contained
• Retry decorator for resiliency