How yuntian-liu/stellaris works
Stellaris is a subtitle-extraction and AI content-understanding web app. A user submits a video URL or file through the frontend; the backend downloads or extracts audio, transcribes it, optionally segments the transcript, and returns subtitle exports and task history. Users can then request summaries, Markdown notes, or streamed chat. Separate product areas cover accounts, three-currency billing, membership fulfillment, admin operations, and vault storage. The README documents the end-to-end pipeline; several subsystem implementations are unsampled, so their internal links are omitted or marked unverified.
Main entry points: main.py HTTP API · api.js API client · database.py SQLite database · asr.py Speech recognition
Components 33
User experience
- App shell
frontend/src/App.jsx - Submit video
frontend/src/pages/HomePage.jsx - Task progress
frontend/src/pages/ProgressPage.jsx - Results and chat
frontend/src/pages/ResultPage.jsx - API client
frontend/src/hooks/api.js
Media and AI pipeline
- HTTP API
backend/main.py - Media acquisition
backend/pipeline/download.py - Speech recognition
backend/pipeline/asr.py - Subtitle processing
backend/pipeline/subtitle.py - AI understanding
backend/pipeline/llm.py - Subtitle export
backend/pipeline/export.py
Accounts and billing
- Account settings
frontend/src/pages/SettingsView.jsx - Login and signup
frontend/src/pages/AuthPage.jsx - Auth state
frontend/src/contexts/AuthContext.jsx - Auth routes
backend/auth/router.py - User records
backend/auth/models.py - Currency billing
backend/billing_store.py - Membership webhook
backend/afdian_store.py - Redeem codes
backend/redeem_store.py
Admin and support
- Admin dashboard
frontend/src/pages/AdminView.jsx - Admin endpoints
backend/main.py - Admin services
backend/admin_store.py - Feedback tickets
backend/ticket_store.py - Database backups
backend/backup_store.py
Platform services
- Model settings
backend/model_store.py - Task history
backend/history_store.py - SQLite database
backend/database.py - User vault
backend/vault_store.py - Chat storage
backend/chat_store.py
Other components
- Video user
- Cloud ASR
- DeepSeek
- 爱发电
Connections 35
- Video user → Submit video: submits URL or file
- Submit video → API client: requests estimate and task
- API client → HTTP API: calls API
- HTTP API → Media acquisition: acquires media
backend/main.py - Media acquisition → Speech recognition: provides audio
- Speech recognition → Cloud ASR: transcribes audio
- Speech recognition → Subtitle processing: produces transcript
- Subtitle processing → AI understanding: segments text
- HTTP API → Subtitle export: exports subtitles
backend/main.py - HTTP API → Task progress: reports task status
- HTTP API → Results and chat: serves task result
- AI understanding → DeepSeek: requests AI output
backend/pipeline/llm.py - AI understanding → Model settings: reads active model
backend/pipeline/llm.py - Results and chat → API client: requests chat and exports
frontend/src/pages/ResultPage.jsx - Video user → Login and signup: signs in or registers
- Login and signup → Auth state: sets login state
frontend/src/pages/AuthPage.jsx - Auth state → API client: validates session
frontend/src/contexts/AuthContext.jsx - Auth routes → User records: reads and updates users
backend/auth/router.py - Auth routes → SQLite database: uses database session
backend/auth/router.py - Account settings → API client: requests account data
- HTTP API → Currency billing: meters operations
backend/main.py - Membership webhook → Currency billing: fulfills membership
- 爱发电 → Membership webhook: sends webhook
- Redeem codes → Currency billing: applies redemption
backend/redeem_store.py - HTTP API → Task history: retains task history
backend/main.py - Task history → SQLite database: stores task records
backend/history_store.py - HTTP API → Admin dashboard: serves admin data
- Admin dashboard → API client: requests admin actions
frontend/src/pages/AdminView.jsx - Admin endpoints → Admin services: delegates admin operations
backend/main.py - Admin endpoints → Feedback tickets: manages tickets
backend/main.py - Admin endpoints → Database backups: manages backups
backend/main.py - Admin services → SQLite database: queries product data
- HTTP API → User vault: handles vault operations
backend/main.py - HTTP API → Chat storage: persists chat turns
backend/main.py - Chat storage → SQLite database: stores chat data
backend/chat_store.py