OpenGeni — The open agent runtime$GitHub↗

Open Source · Apache-2.0/github.com/Cloudgeni-ai/opengeni<br>Theopenagentruntime.<br>Embedit.Self-hostit.Ownit.<br>OpenGeni is a managed-agent service you run yourself. Durable sessions, sandboxed tool execution, replayable event history — and a public API your product talks to directly. Embed it inside your product, or stand one up for your whole org.<br>[Star on GitHub][Read how it works ↓]<br>skill$ npx skills add Cloudgeni-ai/opengeni --skill opengenicopydurable<br>postgres event log

live<br>SSE + NATS fanout

sandboxed<br>pluggable execution

orchestrated<br>temporal workflows

▼ Scroll

────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────

§ 01Two modes

Built to be embedded. Built to be deployed.<br>OpenGeni isn't a developer CLI for one machine. It's a runtime — a tiny operating system for agents that lives wherever you put it.

EMBED<br>Inside your product.<br>Bring real agents into your product. Your UI, your auth, our runtime. OpenGeni owns durable session state, event history, approvals, and final outputs — your customers never know it's there.<br>YOUR SAAS UIOPENGENI API/sessions/events/stream/events

DEPLOY<br>Across your org.<br>Stand up one OpenGeni for your whole company. Any cloud. Your sandboxes, your secrets, your audit trail. A scalable agentic OS that grows with the team — not a single-machine CLI.<br>YOUR ORGteam ateam bteam copengenicontrol planesandboxpostgresyour s3

────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────

§ 02What it is

A durable, observable, interruptible agent service — with the boring infrastructure already wired in.<br>Sessions live in Postgres. Live events stream over SSE with NATS fanout. Long work is coordinated by Temporal. Tool execution happens inside a sandbox you choose. Repos and documents plug in as first-class agent tools.

Session-based API<br>SSE event stream<br>Temporal-orchestrated<br>Sandboxed tool exec<br>Repo + doc tools<br>Postgres event log

────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────

§ 03Architecture

One API in front. Postgres as truth, Temporal as the metronome, a sandbox at the edge.<br>Public clients only ever talk to the Hono API. Postgres is the durable source of truth, NATS handles realtime fanout, and Temporal coordinates long-running work.

[ WEB CLIENT ]React + Vite app[ YOUR PRODUCT ]embedded runtime[ SERVICE ]server-to-server[ CUSTOM CLIENT ]anything that speaks HTTP[ HONO API ]the public contract[ POSTGRES ]sessions · events · vectors[ TEMPORAL ]durable orchestration[ NATS CORE ]live event fanout[ WORKER ]OpenAI Agents SDK[ OBJECT STORE ]S3-compatible[ SANDBOX ]pluggable · session-scoped[ MCP TOOLS ]first-party + plug-ins<br>[ Web Client ]React + Vite app[ Your product ]embedded runtime[ Service ]server-to-server[ Custom Client ]anything that speaks HTTP[ Hono API ]the public contract[ Postgres ]sessions · events · vectors[ Temporal ]durable orchestration[ NATS Core ]live event fanout[ Worker ]OpenAI Agents SDK[ Sandbox ]pluggable · session-scoped[ MCP Tools ]first-party + plug-ins[ Object Store ]S3-compatible

active path request packet<br>hover any node to isolate its connections

Postgres is truth.<br>If an SSE client misses live events, the API backfills from the event log by sequence number. Sessions replay. Always.

NATS is just the bus.<br>Realtime fanout only. Loss-tolerant: durability is somebody else's job (Postgres'). Keeps the hot path cheap.

Workers run agents.<br>Model calls, tool execution, sandbox commands, repo ops — all inside non-retryable Temporal activities, because side-effects.

────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────

§ 04Model sovereignty

Your data, your...