Han Solo
Han Solo
Architecture & Flows
Click any node or flow to trace the path
Claude
(any MCP client)
Web Browser
Scott / Ted
dream.py
nightly cron (launchd)
Render
health check / deploy
BearerAuthMiddleware
auth.py · raw ASGI
FastMCP Server
server.py · /mcp endpoint
config.py
TOKEN_REGISTRY · env vars
validation.py
write contract enforcement
chat_api.py
REST routes · history cache
tools/memory
read/write core blocks
tools/signals
archival signal writes
tools/phase
phase gates · project state
tools/brief
session brief · health
tools/portraits
forming · trusted layers
tools/framework · notecards
project data · captures
letta_client.py
async httpx · auth headers · redirect handling · agent ID resolution
Letta API
han-solo-letta.onrender.com
Core Memory Blocks
always_loaded_core
pending_thoughts
identity blocks
*_portrait_forming/trusted
Archival Memory (vector)
signals · session summaries
foundational passages
Ren Agent
gemini-2.5-flash
memgpt_agent type
Google AI API
gemini-2.5-flash (BYOK)
VoyageAI
voyage-3 embeddings
db.py
two asyncpg pools · health tracking · jobs_paused flag
PostgreSQL
han-solo-data + Framework DB (Render)
chat_transcripts
han_solo_config
signals · notecards
framework_entries/projects/skills
jottings_pages · jottings_replies
memory_access_log
session_logs · agent-memory schema
framework_state/project_content
Dockerfile (MCP)
python:3.11-slim
letta/letta:0.16.8
+ psycopg2-binary
chat_html.py
CHAT_HTML constant
Lifespan
httpx init · DB pool
session manager
CLIENTS
AUTH / SERVER
MCP TOOLS
LETTA CLIENT
DATABASE
EXTERNAL SERVICES
Flows — click to trace
Steps
Select a node or flow to see the full path.
Letta / Memory
Web UI / Chat
MCP Server / Tools
Config / Background
Auth / Validation
Anthropic API
Live call
Async / scheduled