Architecture: nemo-agent

arch-nemo-agent Doc

architecture active

nemo-agent Architecture

Architecture ID used in board labels: arch:nemo-agent

Components

Component Language Framework Responsibility
Webhook server Python FastAPI Receive Postmark inbound POST, parse email, route to project agent
Agent loop Python anthropic SDK Orchestrate workflow via Claude Opus 4.6 tool use
Project configs Markdown Workflow guides per client project

Data Flow

Deployment

  • Namespace: nemo
  • Image: nemo/app (Harbor)
  • Port: 8000 (FastAPI/uvicorn)
  • Exposed via Tailscale funnel for Postmark webhook delivery
  • Overlay: pal-e-deployments/overlays/nemo/prod

Authentication

Service Method
Anthropic API API key (ANTHROPIC_API_KEY)
Postmark Server token + webhook signature
Rails API Bearer token (API_TOKEN)
Stripe API key (STRIPE_SECRET_KEY)
  • project-nemo — project page
  • Repo docs: docs/architecture.md in ldraney/nemo