https://github.com/mar-schmidt/podium
Thin orchestration layer for local LLM agents. Durable sessions, profiles, scheduling. Leans on native MCP/tools/memory instead of replacing them.
https://github.com/mar-schmidt/podium
agent-orchestration ai-agents claude claude-code cli codex go golang llm llm-orchestration mcp svelte
Last synced: about 15 hours ago
JSON representation
Thin orchestration layer for local LLM agents. Durable sessions, profiles, scheduling. Leans on native MCP/tools/memory instead of replacing them.
- Host: GitHub
- URL: https://github.com/mar-schmidt/podium
- Owner: mar-schmidt
- Created: 2026-06-29T12:22:41.000Z (1 day ago)
- Default Branch: master
- Last Pushed: 2026-06-29T21:38:50.000Z (about 16 hours ago)
- Last Synced: 2026-06-29T22:24:31.387Z (about 15 hours ago)
- Topics: agent-orchestration, ai-agents, claude, claude-code, cli, codex, go, golang, llm, llm-orchestration, mcp, svelte
- Language: Go
- Homepage:
- Size: 280 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Security: docs/security.md
- Agents: docs/agents.md
Awesome Lists containing this project
README
# Podium
A thin orchestration layer for local LLM agents (Claude Code, OpenAI Codex atm.).
Podium shells out to the native `claude` and `codex` CLIs and leans on *their*
MCP, tools, and memory, while owning its own durable truth: named agents, durable
chat sessions, a canonical history that replays onto a fresh backing CLI session
on any profile/provider switch, an embedded scheduler, and a shared project
ledger. It ships as a single Go binary with an embedded Svelte web UI.
## Quick start (dev)
### Install
macOS/Linux:
```sh
curl -fsSL https://github.com/mar-schmidt/Podium/releases/latest/download/install.sh | bash
```
Windows PowerShell:
```powershell
irm https://podium.ai/install.ps1 | iex
```
The installer downloads the matching release binary, verifies checksums, can set
up user-level autostart, and launches `podium onboard` to check Claude/Codex and
create your first agent.
Every commit to `master` publishes a GitHub Release using the automatic
`v0.1.` series. That series is intentionally monotonic rather than
calendar-based, so bursts of work can produce many releases without implying a
monthly cadence.
After install, updates can be checked and applied from the CLI or web UI:
```sh
podium update check
podium update apply --yes
```
Linux releases are distro-neutral static binaries.
### Development
Prerequisites: Go 1.26+, Node 20+ (for building the web UI).
```sh
# Build the web UI (vite) and both binaries into bin/ with a version stamp.
make build
# Run the daemon (foreground). It scaffolds ~/.podium on first run.
./bin/podiumd
# In another shell, check it's live.
./bin/podium status
```
Open http://127.0.0.1:8787 for the web UI.
To develop the frontend with hot reload, run `npm run dev` in `web/` (it proxies
API/WebSocket traffic to a running `podiumd`).
### Cross-platform builds & packaging
`podiumd` is a single static binary with the SPA embedded — no external assets,
no cgo (pure-Go SQLite via `modernc.org/sqlite`), so it cross-compiles cleanly:
```sh
make cross # linux/darwin/windows × amd64/arm64 → bin/-/
make package # archives release artifacts into dist/ and writes SHA256SUMS
```
All runtime state lives under one overridable root, so running Podium as a Home
Assistant add-on or in a container is a packaging step, not a rewrite:
```sh
PODIUM_HOME=/data/podium ./bin/podiumd # relative values are anchored absolute
```
The web bind is configurable in `config.yaml` (`server.bind` / `server.port`,
default `127.0.0.1:8787`); see [Configuration](docs/configuration.md).
## Layout
```
cmd/podium/ thin CLI client
cmd/podiumd/ daemon: web server + scheduler + core
internal/ core, adapter, exec, schedule, config, store, server, client
web/ Svelte + Vite + TS + Tailwind SPA (built → embedded)
docs/ requirements, CLI reference, configuration, integration contracts
```
All runtime state lives under `$PODIUM_HOME` (default `~/.podium/`).
## Documentation
- [Requirements](docs/requirements.md) — the authoritative spec (v1.6).
- [CLI reference](docs/cli.md)
- [Configuration](docs/configuration.md)
- [Scheduling](docs/scheduling.md)
- [Projects & Roadmap](docs/projects.md)
- [Security & logging](docs/security.md) — permission modes, redaction, run logs
- [Integration contracts](docs/integrations/README.md)