Project Dashboard

MEGATON

FastAPI backend evolving into a multi-service companion platform

FastAPISQLAlchemyAlembicRedisElevenLabs
StatusActive
Version0.1.0
ReportApr 18
Progress63%
Platform Migration5/8 Tasks
01
Code Metrics
Python Source
4,302lines
Test Coverage
3,900lines
Source Files
64files
Test Files
20files
Migrations
7
Frontend Pages
7
n8n Workflows
2
CF Workers
1
02
Implementation Plan
Implementation progress visualization
Complete

5

In Progress

2

Pending

1

03
System Architecture
MEGATON System Architecture — FastAPI Gateway connected to Character, Memory, Presence, World, Voice, and Auth engines
Active Engine
Partial / Refactoring
Planned

The FastAPI Gateway remains the permanent API entrypoint. Platform domain engines are wired behind it in phases: identity, characters, conversation/memory, schedule/presence, social world, and realtime voice.

04
Service Modules
10 active4 partial14 total
FastAPI GatewayMain API entrypoint with CORS, rate limiting, security headers
ACTIVE
Auth / IdentityJWT auth, register, login, platform-ready user payloads
ACTIVE
Character EngineCharacter lookup, visible filtering, companion ranking
ACTIVE
Presence EngineSchedule resolution, availability state, time-zone aware
ACTIVE
Conversation EngineOpen/send/history, Ashi compatibility facade
ACTIVE
Memory EngineDurable memory retrieval, ranking, summarization
ACTIVE
World EngineFeed, rooms, cross-character activity
ACTIVE
Response EngineCharacter-aware response generation (refactoring)
PARTIAL
Voice / RealtimeWebSocket live voice with ElevenLabs TTS
PARTIAL
Ashi PersonaTasking, emotional, camera, identity modules
PARTIAL
Redis Session StoreLive session state, profile memory, WebSocket flows
ACTIVE
n8n AutomationWorkflow triggers, sync-items, build-status
ACTIVE
Cloudflare Workerashi-dttc-proxy for ashi.dttc.io domain
ACTIVE
Next.js FrontendMinimal shell with character/world/dashboard pages
PARTIAL
05
Operational Health
1 Critical
1 Warning
3 Total Issues
AttributeError in Live Voice WebSocketCRITICAL

AshiService object has no attribute 'live_memory_status'. Causes 500 on /voice/profile and breaks WebSocket connections.

src/app/routes/voice_ws.py:121
2026-04-18 00:09
Port Binding Conflict on :8000WARNING

Errno 10048 — address already in use. Multiple uvicorn instances may be running simultaneously.

uvicorn.stderr.log
2026-04-15 03:53
Missing favicon.icoINFO

Browser requests return 404 for /favicon.ico. Cosmetic issue only.

codex-live-voice.out.log
2026-04-16 16:47
06
API Endpoints
GET/health
active
GET/voice/live
active
WS/voice/ws
degraded
POST/api/auth/register
active
POST/api/auth/login
active
GET/api/auth/me
active
GET/api/items/
active
POST/api/items/
active
POST/api/ashi/chat
active
GET/api/ashi/status
active
GET/api/ashi/history
active
GET/api/characters/visible
active
GET/api/me/companions
active
POST/api/conversations/open
active
POST/api/conversations/{id}/messages
active
GET/api/world/feed
active
GET/api/world/rooms
active
POST/api/ashi/n8n/trigger
active
POST/api/ashi/n8n/workflows/sync-items
active
19 endpoints shown
07
Recent Activity
File Changes15 recent
services/ashi_persona/tasking.py
MODIFIEDApr 18, 00:14
services/ashi_persona/emotional.py
MODIFIEDApr 18, 00:13
models/ws_models.py
MODIFIEDApr 18, 00:09
services/ashi_service.py
MODIFIEDApr 18, 00:09
services/response_engine.py
MODIFIEDApr 18, 00:09
routes/voice_ws.py
MODIFIEDApr 17, 13:13
routes/voice.py
MODIFIEDApr 17, 13:09
services/voice_streaming.py
MODIFIEDApr 17, 13:09
services/session_store.py
MODIFIEDApr 17, 13:05
services/ashi_persona/camera.py
MODIFIEDApr 17, 12:54
services/platform_world_engine.py
CREATEDApr 17, 12:43
routes/platform_world.py
CREATEDApr 17, 12:43
models/platform_world.py
CREATEDApr 17, 12:43
services/platform_character_engine.py
CREATEDApr 17, 12:43
routes/platform_characters.py
CREATEDApr 17, 12:43
08
Strategic Recommendations
Fix live_memory_status AttributeErrorHIGH

Update AshiService to implement the live_memory_status method, or adjust voice_ws.py to match the refactored service interface.

Restores core live voice functionality
Stabilize Local Dev EnvironmentHIGH

Address port binding issues. Use Docker Compose consistently or implement robust process management to prevent conflicts.

Reliable local testing and development
Complete Frontend IntegrationMEDIUM

Wire the Next.js shell to consume platform APIs. Bring the character gallery, world feed, and dashboard to life.

User-facing product surface ready for testing
Finalize Database Migration StrategyMEDIUM

Test Alembic migrations against PostgreSQL. Current docker-compose mounts SQLite but production targets asyncpg.

Prevents deployment surprises