Groundwork

A self-hostable, managed agent service for long-running infrastructure work.

Groundwork architecture

Groundwork runs AI agents inside pluggable sandboxes (Docker / Modal / local), orchestrated by Temporal, with a durable, replayable event log in Postgres and live streaming over NATS + SSE. Multi-cloud object storage, pgvector RAG, GitHub App integration, and scheduled tasks are built in.

• Runtime — Bun + TypeScript
• API — Hono
• Web — React + Vite
• Orchestration — Temporal
• Datastore — Postgres + pgvector (Drizzle ORM)
• Eventing — NATS + SSE
• Agents — OpenAI Agents SDK
• Sandboxes — Docker / Modal / local

bun install
bun run dev # starts docker infra, runs migrations, then api + worker + web

• Web http://127.0.0.1:3000 · API health http://127.0.0.1:8000/healthz