How pulkitpareek18/intellimix works
IntelliMix is an AI-first music-mixing studio. Its main workflow runs from an authenticated user’s chat request, through draft planning and revision, to timeline editing and asynchronous mix rendering; the UI then presents versions and run status. The graph also includes documented history, downloads, and media-processing tools. Relationships come from the excerpts, SOURCE INDEX references, and README; some database and storage details are documented only at the architecture level, and unsampled implementation specifics are not inferred.
Main entry points: app.py Flask API · mix_chat_runner.py Run orchestrator · App.tsx Web application · api.ts API client
Components 26
Web client
- Web application
frontend/src/App.tsx - Authentication UI
frontend/src/context/AuthContext.tsx - Mix chat studio
frontend/src/pages/AIParody.tsx - Timeline editor
frontend/src/components/TimelineEditorPanel.tsx - History screen
frontend/src/pages/History.tsx - Audio tool screens
frontend/src/pages/YouTubeTrimmer.tsx - API client
frontend/src/utils/api.ts
API and runs
- Flask API
backend/app.py - Run orchestrator
backend/mix_chat_runner.py - Run queue
backend/mix_chat_queue.py - Background worker
backend/mix_chat_worker.py - PostgreSQL
- Redis
- Media storage
Mix planning
- Mix agent flow
backend/ai/mix_agent_flow.py - Mix and audio analysis
backend/ai/ai_main.py - Gemini service
backend/ai/ai.py - Planning prompts
backend/ai/planning_prompts.py
Media processing
- Audio engineering
backend/features/audio_engineer_tools.py - Audio merging
backend/features/audio_merge.py - Track downloads
backend/features/audio_download.py - Video download
backend/features/download_video.py - Audio download
backend/features/download_audio.py - Audio splitting
backend/features/audio_split.py - CSV processing
backend/features/read_csv.py
Other components
- User
Connections 33
- User → Web application: uses
- Web application → Authentication UI: provides auth
frontend/src/App.tsx - Web application → Mix chat studio: routes to
frontend/src/App.tsx - Web application → History screen: routes to
frontend/src/App.tsx - Web application → Audio tool screens: routes to
frontend/src/App.tsx - Mix chat studio → API client: requests
frontend/src/pages/AIParody.tsx - Mix chat studio → Timeline editor: opens editor
frontend/src/pages/AIParody.tsx - Timeline editor → API client: requests
frontend/src/components/TimelineEditorPanel.tsx - History screen → API client: requests
frontend/src/pages/History.tsx - Audio tool screens → API client: requests
frontend/src/pages/YouTubeTrimmer.tsx - API client → Flask API: REST and SSE
- Flask API → Run orchestrator: orchestrates
backend/app.py - Flask API → Run queue: enqueues runs
backend/app.py - Background worker → Run queue: dequeues runs
backend/mix_chat_worker.py - Background worker → Run orchestrator: executes runs
backend/mix_chat_worker.py - Run orchestrator → Mix agent flow: plans mixes
backend/mix_chat_runner.py - Run orchestrator → Mix and audio analysis: uses analysis
backend/mix_chat_runner.py - Run orchestrator → Gemini service: uses AI
backend/mix_chat_runner.py - Run orchestrator → Planning prompts: uses prompts
backend/mix_chat_runner.py - Mix agent flow → Mix and audio analysis: uses analysis
backend/ai/mix_agent_flow.py - Mix agent flow → Audio engineering: engineers audio
backend/ai/mix_agent_flow.py - Audio engineering → Mix and audio analysis: analyzes tracks
backend/features/audio_engineer_tools.py - Audio engineering → Track downloads: downloads tracks
backend/features/audio_engineer_tools.py - Audio engineering → Audio merging: uses merging
backend/features/audio_engineer_tools.py - Flask API → PostgreSQL: reads and writes
- Flask API → Media storage: serves files
- Run queue → Redis: queues runs
- Background worker → PostgreSQL: updates runs
- Background worker → Media storage: stores output
- Flask API → Video download: routes downloads
backend/app.py - Flask API → Audio download: routes downloads
backend/app.py - Flask API → Audio splitting: routes processing
backend/app.py - Flask API → CSV processing: routes processing
backend/app.py