Skip to content
Agent Bootstrapper
YOUR INFRASTRUCTURE HERMES + CODEX

A place for your
agents to work.

Run persistent Hermes agents and focused Codex tasks on your own infrastructure. Keep their setup, connections, and status in one place.

Get startedView on GitHub

PRIVATE INFRASTRUCTUREYOUR AGENTS

Hermes
// Create a persistent agent
POST /agents/hermes

{
  "name": "research-assistant",
  "modelRoute": "your-model-route",
  "resources": {
    "requests": {
      "cpu": "500m",
      "memory": "1Gi"
    },
    "limits": {
      "memory": "2Gi"
    }
  }
}

Example request · runs on your private API

What's inside

Agents with a home

Give each Hermes agent persistent storage and a model connection. Launch Codex runners for individual tasks.

One clear workspace

Keep agent creation, connections, and runtime status together behind a small control API.

Connected on your terms

Set up separate Telegram profiles, choose who can reach them, and organize conversations with topics.

Choose the right runtime

Long-running agents and focused jobs each get the workload model they need.

Built for developers

Use a typed API with explicit request contracts. Create, inspect, and clean up your managed workloads.

Your cluster is the source

Resource discovery stays label-driven, with no separate agent metadata database.

See how it fits together

Always a place
to pick up where you left off.
Persistent Hermes agentsYour infrastructure. Connected.
One task.
Full focus.
Codex task runnersSmall pieces. One workspace.

A home for the whole workflow.

Persistent agents, focused tasks, and the connections between them.
Bring the pieces together on infrastructure you control.

Explore the architecture

Hermes agents

PERSISTENT RUNTIMES

Codex runners

FOCUSED TASKS

Telegram profiles

YOUR CONNECTIONS

A typed control API

DEVELOPER INTERFACE

Kubernetes workloads

YOUR INFRASTRUCTURE

Start with the source.

A small control plane with explicit configuration.
Get the code, validate your checkout, and follow the deployment guide for your cluster.

Installation guide

Built with TypeScript, Bun, pnpm, and Kubernetes.

pnpmGetting started
01

GET THE SOURCE

git clone https://github.com/stark-ai-de/agent-bootstrapper.git
02

INSTALL DEPENDENCIES

cd agent-bootstrapper && pnpm install --frozen-lockfile
03

VALIDATE YOUR CHECKOUT

pnpm run validate
agent-bootstrapper
apps bootstrapper web packages api-contract ui deploy README.md
your agents.
your cluster.
your code.

Your infrastructure.
Your rules.

Agent Bootstrapper coordinates workloads. You keep control of the runtime, the credentials, and the place your agents call home.

  • Private by design

    The control API stays inside your cluster.

  • State where it belongs

    Persistent agent storage lives in Kubernetes volumes.

  • Small, explicit building blocks

    Deployments, Jobs, labels, and a documented API.

Give your agents a place to work.

Persistent agents. Focused tasks. Your infrastructure.
Start with a small control plane and build from there.

Read the documentationView on GitHub