OSS/podman

Files

T

Ramis 923ab1cf58 docs: finalize PodMan architecture and write full integration specs

Replaces v1 plan with locked architecture:
- Hermes orchestrator: POST /ingest → Gemini Vision → MongoDB → event detection → Gemini Live 2.5 voice via LiveKit Agents
- Four MongoDB collections: engineer_states, ownership_map, events, nudges
- Continual learning via ownership_map persisting across sessions

New files: docs/idea.md, docs/gemini.md, docs/livekit.md, docs/mongodb.md, docs/digitalocean.md, docs/demo-setup.md
Updated: README.md, docs/PLAN.md (12-hour build plan), database/README.md, infra/README.md, .env.example

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FFbfi4Cmb7BY75Wtne7bZn

2026-06-27 15:27:23 -07:00

2.8 KiB

Raw Blame History

DigitalOcean Deployment Spec

PodMan backend (Hermes) runs on DigitalOcean. Frontend is served as a static site. Both are deployed from the same monorepo.

Services

1. Hermes — Backend API + LiveKit Agent

Type: DigitalOcean App Platform — Web Service (or Droplet if App Platform has issues)

Runtime: Node.js 20

Build command: pnpm --filter backend build

Run command: node dist/index.js

Port: 8787 (set via PORT env var)

Resources: Basic ($12/mo) — 1 vCPU, 1GB RAM. Sufficient for hackathon load.

2. Frontend PWA — Static Site

Type: DigitalOcean App Platform — Static Site

Build command: pnpm --filter frontend build

Output directory: frontend/dist

Routes: SPA — all routes → index.html

Environment variables (set in App Platform dashboard)

# LiveKit
LIVEKIT_URL=wss://your-livekit-server.livekit.cloud
LIVEKIT_API_KEY=
LIVEKIT_API_SECRET=

# Gemini
GEMINI_API_KEY=
GEMINI_VISION_MODEL=gemini-2.0-flash
GEMINI_LIVE_MODEL=gemini-live-2.5-flash

# MongoDB Atlas
MONGODB_URI=mongodb+srv://...

# Server
PORT=8787

# Frontend (Vite — set in App Platform as static site env vars)
VITE_BACKEND_URL=https://your-hermes-app.ondigitalocean.app
VITE_LIVEKIT_URL=wss://your-livekit-server.livekit.cloud

Dockerfile (backend)

Located at infra/Dockerfile. Already scaffolded. Ensure it:

Uses node:20-slim
Installs pnpm
Copies workspace root + backend package
Runs pnpm install --frozen-lockfile
Runs pnpm --filter backend build
CMD ["node", "backend/dist/index.js"]

App Platform spec (`infra/app.yaml`)

Already scaffolded. Key fields to confirm before deploy:

services:
  - name: hermes
    source_dir: /
    dockerfile_path: infra/Dockerfile
    http_port: 8787
    instance_size_slug: basic-xxs
    envs:
      - key: LIVEKIT_URL
        scope: RUN_TIME
        value: ${LIVEKIT_URL}
      # ... other vars

static_sites:
  - name: frontend
    source_dir: frontend
    build_command: pnpm build
    output_dir: dist
    index_document: index.html
    error_document: index.html

Deploy checklist

MongoDB Atlas IP allowlist: add DigitalOcean outbound IPs (or allow all: 0.0.0.0/0 for hackathon)
LiveKit Cloud: confirm LIVEKIT_URL points to your LiveKit Cloud project
Gemini API key has quota for gemini-2.0-flash + gemini-live-2.5-flash
VITE_BACKEND_URL set to the deployed Hermes URL (not localhost)
Test GET /health returns { ok: true } after deploy

Fallback plan (if App Platform deploy fails on stage)

Run Hermes locally:

cd backend && pnpm dev

Frontend already points to http://localhost:8787 by default via VITE_BACKEND_URL fallback. Demo works fully local — no DigitalOcean dependency for the live demo itself.

2.8 KiB Raw Blame History