Cordium
github.com/octelium/cordium- Category
- Developer Tools
- Rank
- No. 1328Tools index
- Pricing
- Open Source
- Type
- TOOL
- Use case
- Deployment & Operations · Security & Identity
- Interfaces
- Web · CLI · Client SDK
- GitHub
- 88 stars
- Latest release
- v0.20.0
- Date
About
Cordium is a self-hosted sandbox platform on Kubernetes for developers and AI agents. Each sandbox gets an identity through the Octelium zero-trust client, and access proxies hold the upstream credentials and inject them only when a policy allows the request. Sandboxes therefore never store API keys, SSH keys or database passwords, which limits what a compromised sandbox or agent can leak.
What it does
You install it on your own Kubernetes cluster and get workspaces: rootless containers that a person opens in a browser, over SSH or from an editor, and that a program or coding agent drives through a command line tool or a Go client. Each workspace logs in as its own identity on Octelium, a zero-trust access platform from the same authors. When code inside calls a database, an SSH host or a model provider, Octelium's proxy checks policy and attaches the real credential on the way out, so the sandbox itself never holds it.
Why it's ranked here
Most agent sandboxes answer one question, how to run untrusted code safely. Cordium also answers the next one, how that code reaches private systems without a pasted API key, and it does so on plain Kubernetes nodes with no separate virtual machine per sandbox. It is Apache 2.0, aimed at single-tenant self-hosting, and the repository carries a full Go module set for the API server, supervisor, portal and command line tool. Its Go client is built for programs, not just people, which is the audience agent sandboxes serve.
What's good
The Go client treats a failing command as a result, not an error: you get the exit code and captured output, and only a transport failure returns an error. A separate argument-list form passes untrusted input, such as a URL a model produced, without shell interpretation. Output capture is capped at 1 MiB by default and flagged when truncated. Workspace creation returns the handle even if a later startup step fails, so nothing leaks. Egress can be set to default-deny by address range and port, enforced outside the sandbox, and snapshots let you fork a filesystem for parallel agent runs.
Tradeoffs
It is not a standalone tool. Everything runs on top of an Octelium cluster, so adopting it means adopting Octelium's identity, policy and login model as well. Isolation is a rootless container per Kubernetes pod rather than a dedicated virtual machine, which is lighter but a weaker boundary than microVM sandboxes. The execution protocol cannot close standard input on its own, so commands that read until end of file need a terminate-on-exhaustion workaround. File transfer rides the command stream as base64 and needs coreutils or busybox inside the image. The README promises Python, Rust and TypeScript clients, but the only client documented in the repository is Go.
How to use it well
Fit it where a team already runs Kubernetes and wants agents or CI jobs to reach internal databases, SSH hosts or model providers without handing out keys. Start with the single-node quick install, define workspaces as YAML templates with setup tasks, and turn on default-deny egress before letting an agent run untrusted code. From Go, build commands from argument lists for anything a model writes. If you only need a throwaway code interpreter with no access to private systems, a hosted sandbox is less to operate.
Technical notes+
go.work lists fifteen modules, including cluster/apiserver, cluster/supervisor, cluster/portal, cluster/vigil, cluster/workspace, client/cordium and cordium-go. client/cordium/main.go is a thin cobra entry point. cordium-go/client.go wraps an octelium-go Client and opens three generated gRPC clients (MainService, WorkspaceService, ManagementService) on one shared connection, and installs a custom HTTP authorization policy because portal app hostnames use underscores that Octelium's default policy rejects. cordium-go/exec.go sets defaultMaxCaptureBytes to 1 MiB, defaultKillGracePeriod to 10 seconds (the cluster sends SIGTERM then SIGKILL after 5), and ExitCode -1 for signalled commands; WithTerminateOnStdinEOF exists because the protocol has no stdin half-close. cluster/agent/src/index.ts shows the built-in assistant is a TypeScript package exporting an API catalog and client.
Observed
- License
- Apache 2.0 (LICENSE file in repository root)
- Language
- Go workspace of fifteen modules, plus a TypeScript package for the built-in agent
- Interfaces
- Web portal, SSH, cordium CLI, gRPC API with a Go SDK module in the repository
- Dependency
- Requires an Octelium cluster for identity, policy and credential injection
- Platform
- Self-hosted on Kubernetes, single-node VM or multi-node cluster; CLI for Linux, macOS and Windows
- Isolation model
- Rootless container per Kubernetes pod under a supervisor, no per-workspace VM
- SDK languages
- README names Go, Python, Rust and TypeScript; the Go SDK is documented in cordium-go/README.md
Read from README.md, LICENSE, go.work, cordium-go/README.md, cordium-go/client.go, cordium-go/exec.go, client/cordium/main.go, cluster/agent/src/index.ts.
Tags
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.