How isaias-morais/atlas0.1 works
ATLAS is a web-based personal assistant: users enter text or voice commands, the API interprets them, dispatches known command types to services, and returns results that the frontend can act on. Separate API paths support login, user management, and reminder CRUD. The README also describes a future AI path, but the sampled evidence does not establish how it connects to command dispatch; the AI and music capabilities are therefore shown as distinct, with uncertain integration omitted.
Main entry points: command_routes.py Command endpoint · main.py FastAPI application · connection.py Database sessions · script.js Web interface
Components 31
Web interface
- Web interface
frontend/js/script.js - Voice input
frontend/js/voice.js - Login client
frontend/js/login.js - Auth client
frontend/js/auth.js - Command client
frontend/js/api.js - Music playback
frontend/js/music.js
API and identity
- FastAPI application
backend/app/main.py - Auth routes
backend/app/routes/auth_routes.py - User routes
backend/app/routes/user_routes.py - Reminder routes
backend/app/routes/reminder_routes.py - Token validation
backend/app/security/auth.py - Login service
backend/app/services/auth_service.py
Command handling
- Command endpoint
backend/app/routes/command_routes.py - Command interpreter
backend/app/interpreter/interpreter.py - Command dispatcher
backend/app/dispatcher/dispatcher.py - Request schemas
backend/app/schemas/command_scherma.py
Assistant features
- Reminder service
backend/app/services/reminder_service.py - User service
backend/app/services/user_service.py - Music service
backend/app/services/music_service.py - YouTube provider
backend/app/providers/youtube_provider.py - AI service
backend/app/services/ai_service.py - AI provider router
backend/app/ai/router.py - AI provider interface
backend/app/ai/providers/base.py - Fake AI provider
backend/app/ai/providers/fake.py
Persistence
- Database sessions
backend/app/database/connection.py - ORM metadata
backend/app/database/base.py - User records
backend/app/models/user.py - Reminder records
backend/app/models/reminder.py - User repository
backend/app/repositories/user_repository.py - Reminder repository
backend/app/repositories/reminder_repository.py
Other components
- Assistant user
Connections 41
- Assistant user → Web interface: uses
- Web interface → Voice input: captures speech
frontend/js/script.js - Web interface → Command client: submits commands
frontend/js/script.js - Web interface → Auth client: uses login
frontend/js/script.js - Login client → Auth client: calls login
frontend/js/login.js - Voice input → Command client: sends text
frontend/js/voice.js - Command client → Music playback: plays music
frontend/js/api.js - Command client → Command endpoint: HTTP command
frontend/js/api.js - Auth client → Auth routes: HTTP login
frontend/js/auth.js - FastAPI application → Auth routes: registers
backend/app/main.py - FastAPI application → Command endpoint: registers
backend/app/main.py - FastAPI application → User routes: registers
backend/app/main.py - FastAPI application → Reminder routes: registers
backend/app/main.py - Command endpoint → Command interpreter: interprets text
backend/app/routes/command_routes.py - Command endpoint → Command dispatcher: dispatches command
backend/app/routes/command_routes.py - Command endpoint → Token validation: authenticates
backend/app/routes/command_routes.py - Command endpoint → Database sessions: gets session
backend/app/routes/command_routes.py - Command interpreter → Request schemas: produces command
backend/app/interpreter/interpreter.py - Command dispatcher → Request schemas: uses command types
backend/app/dispatcher/dispatcher.py - Command dispatcher → Music service: handles music
backend/app/dispatcher/dispatcher.py - Command dispatcher → Reminder service: handles reminders
backend/app/dispatcher/dispatcher.py - Music service → YouTube provider: uses provider
backend/app/services/music_service.py - Reminder routes → Reminder service: calls CRUD
backend/app/routes/reminder_routes.py - Reminder routes → Token validation: authenticates
backend/app/routes/reminder_routes.py - Reminder routes → Database sessions: gets session
backend/app/routes/reminder_routes.py - User routes → User service: calls CRUD
backend/app/routes/user_routes.py - User routes → Database sessions: gets session
backend/app/routes/user_routes.py - Auth routes → Login service: calls login
backend/app/routes/auth_routes.py - Login service → User repository: finds user
backend/app/services/auth_service.py - User service → User repository: uses repository
backend/app/services/user_service.py - Reminder service → Reminder repository: uses repository
backend/app/services/reminder_service.py - Reminder service → User repository: checks owner
backend/app/services/reminder_service.py - User repository → User records: queries records
backend/app/repositories/user_repository.py - Reminder repository → Reminder records: queries records
backend/app/repositories/reminder_repository.py - User records → ORM metadata: maps ORM
backend/app/models/user.py - Reminder records → ORM metadata: maps ORM
backend/app/models/reminder.py - FastAPI application → Database sessions: creates schema
backend/app/main.py - Database sessions → ORM metadata: binds metadata
- AI service → AI provider interface: uses interface
backend/app/services/ai_service.py - Fake AI provider → AI provider interface: implements provider
backend/app/ai/providers/fake.py - AI provider router → AI provider interface: provider routing