How death34018-hue/aionshome works
Aion Chat is a self-hosted, multi-device AI companion: browser or Android clients send chat and feature requests to a FastAPI service, which builds context, invokes an AI provider, and streams results back. Its documented capabilities include memory, voice, camera monitoring, scheduling, group chat, MCP entertainment, and many domain pages. The tree also contains an Android companion shell and a separate Visitor Lounge service. Edges follow the README’s stated architecture and the sampled source; several unsampled feature internals are represented at their documented module or directory level.
Main entry points: routes Feature APIs · main.py FastAPI entry · WebViewActivity.java Android shell · chat.js Web client
Components 21
User clients
- Web client
aion-chat/static/chat.js - Android shell
AionApp/app/src/main/java/com/aion/chat/WebViewActivity.java
API and orchestration
- FastAPI entry
aion-chat/main.py - Chat API
- Feature APIs
aion-chat/routes - WebSocket hub
aion-chat/ws.py
Conversation intelligence
- Context builder
aion-chat/context_builder.py - AI providers
aion-chat/ai_providers.py - Memory retrieval
aion-chat/memory.py
Product capabilities
- Schedules and alarms
aion-chat/schedule.py - Camera monitoring
aion-chat/camera.py - Voice and TTS
aion-chat/voice.py - Group chat
aion-chat/chatroom.py - Interactive theater
aion-chat/theater_studio.py - MCP entertainment
aion-chat/mcp_client.py - Repair workflow
aion-chat/repair_routes.py - Visitor Lounge
AionsHome-Visitor-Lounge/src/visitor_lounge/visitor_app.py
State and integrations
- SQLite state
aion-chat/database.py - Device bridges
AionApp/app/src/main/java/com/aion/chat/AionPushService.java
Other components
- User
- AI services
Connections 24
- User → Web client: uses
- User → Android shell: uses
- Web client → FastAPI entry: HTTP requests
- Android shell → FastAPI entry: loads and syncs
- FastAPI entry → Chat API: registers routes
- FastAPI entry → WebSocket hub: serves WebSocket
- Chat API → Context builder: builds context
- Chat API → AI providers: requests generation
- Context builder → Memory retrieval: retrieves memories
- Memory retrieval → SQLite state: reads and writes
- Chat API → SQLite state: persists messages
- AI providers → AI services: calls models
- Chat API → WebSocket hub: streams replies
- WebSocket hub → Web client: pushes updates
- FastAPI entry → Feature APIs: registers APIs
- Feature APIs → Schedules and alarms: manages schedules
- Feature APIs → Camera monitoring: controls monitoring
- Feature APIs → Voice and TTS: controls voice
- Feature APIs → Group chat: serves group chat
- Feature APIs → Interactive theater: serves theater
- Feature APIs → MCP entertainment: exposes tool calls
- Feature APIs → Repair workflow: serves repair tasks
- Android shell → Device bridges: provides native bridges
- User → Visitor Lounge: visits