How malikmutaher/nexus-ai works
NEXUS AI OS is a web-based personal assistant. A user enters a chat or uses a dedicated workspace; the frontend sends requests to FastAPI, whose chat path can route commands to assistant tools, while feature-specific API paths support memory, files, tasks, notes, and live information. The tree also shows vision and media capabilities. Source excerpts confirm the application shell, task requests, tool routing, memory persistence, and YouTube search; links for other unsampled feature handlers are intentionally limited.
Main entry points: main.py FastAPI app · App.tsx App shell · ai_service.py AI service · tool_manager.py Command routing
Components 23
Assistant interface
- App shell
src/App.tsx - Chat workspace
src/pages/ChatPage.tsx - Feature pages
src/pages - API client
src/services/api.ts
API and chat
- FastAPI app
backend/main.py - Chat endpoint
backend/routers/chat.py - AI service
backend/services/ai_service.py - LLM client
backend/ai/llm.py - Command routing
backend/tools/tool_manager.py
Personal workspace
- Memory operations
backend/tools/memory_manager.py - Tasks and notes
backend/tools/productivity.py - Memory endpoint
backend/routers/memory.py - Tasks endpoint
backend/routers/tasks.py - Notes endpoint
backend/routers/notes.py - Files endpoint
backend/routers/files.py - SQLite database
backend/database.py
Live capabilities
- Vision endpoint
backend/routers/vision.py - Media endpoint
backend/routers/media.py - YouTube search
backend/services/youtube_service.py - Live information
backend/services - System controls
backend/routers/system.py
Other components
- User
- YouTube API
Connections 26
- User → App shell: uses
- App shell → Chat workspace: selects chat
- App shell → Feature pages: selects workspace
- Chat workspace → API client: requests
- Feature pages → API client: requests
- API client → FastAPI app: calls API
- FastAPI app → Chat endpoint: dispatches
- FastAPI app → Memory endpoint: dispatches
- FastAPI app → Tasks endpoint: dispatches
- FastAPI app → Notes endpoint: dispatches
- FastAPI app → Files endpoint: dispatches
- FastAPI app → Vision endpoint: dispatches
- FastAPI app → Media endpoint: dispatches
- FastAPI app → Live information: dispatches
- FastAPI app → System controls: dispatches
- Chat endpoint → AI service: delegates
- AI service → LLM client: uses
- AI service → Command routing: routes commands
- Command routing → Memory operations: dispatches
- Command routing → Tasks and notes: dispatches
- Memory endpoint → Memory operations: uses
- Tasks endpoint → Tasks and notes: uses
- Memory operations → SQLite database: reads and writes
- Tasks and notes → SQLite database: reads and writes
- YouTube search → YouTube API: searches
- Media endpoint → YouTube search: uses