Show HN: AstraBox – an open-source alternative to Claude Managed Agents

AstraBox, an Apache-2.0 open-source, self-hosted alternative to Claude Managed Agents, was released, letting developers run Claude Code, Codex, Hermes, DeepSeek Harness and Pi as cloud agents on their own infrastructure with any model. The deployment bundles LiteLLM as a default model gateway, Casdoor for OIDC team login, OpenSandbox for isolated sandboxes, and Satori adapters for schedules, signed webhooks and messaging triggers, with sessions lasting about 2 minutes and credentials injected at the sandbox egress boundary so the agent only sees a placeholder.

The open-source, self-hosted alternative to Claude Managed Agents. No signup. Ask an Agent to write and run code with a free model. Offline sandbox · Sessions last about 2 minutes. Open source · Self-hosted · Apache-2.0 English · 简体中文 https://github.com/Colton-z/AstraBox/blob/main/README.zh-CN.md Turn the Agent programs you already use into cloud Agents that stay available 24/7. AstraBox runs Claude Code, Codex, Hermes, DeepSeek Harness and Pi on your own infrastructure, with any model. Conversations start and resume in seconds; Sessions, sandboxes, credentials and history stay under your control. You do not have to turn an Agent program into a service yourself, manage sandbox lifecycle, or maintain long-lived connections. Deploy AstraBox, create an Agent in the web console, and start a Session. Complex tasks run in a cloud sandbox while results stream back in real time. AstraBox runs the Agent programs you already use as cloud Agents that can be reached remotely, continue long-running work, and connect to your applications, automations, and messaging platforms. The web console, API, Session records, authentication, and sandboxes all run on infrastructure you control. One platform for team Agents and personal Assistants. An Agent https://github.com/Colton-z/AstraBox/blob/main/docs/authoring-agents.md is a reusable cloud Agent for teams and automation, started from the web console, the API, schedules, webhooks, messaging platforms or an MCP client. An Assistant https://github.com/Colton-z/AstraBox/blob/main/docs/assistants.md is one person's long-lived cloud workspace: all of its conversations share one workspace and the Agent program's state. | Concept | Description | Analogy | |---|---|---| | Agent | A cloud Agent powered by an installed Agent program | "Cloud teammate" | | Environment | The Agent program, sandbox, model connection, network access, and lifecycle used for a Session | "Desk and toolbox" | | Session | One stateful Agent execution, including its messages, Events, and current state | "A specific piece of work" | | Event | The real-time output and state changes produced by a Session | "Live progress feed" | Through these resources, developers can run interactive or long-running tasks, connect remote or local MCP servers, Plugins, Skills, and repositories, trigger Agents from schedules, webhooks, APIs, and messaging platforms, and protect access with authentication, authorization, isolated sandboxes, and managed credentials. Explore AstraBox capabilities → https://github.com/Colton-z/AstraBox/blob/main/docs/capabilities.md One deployment brings up the pieces a team usually assembles by hand: - Model gateway — LiteLLM https://github.com/BerriAI/litellm is bundled and on by default: one route name per model, upstream keys held on the server, budgets and usage logs, and any Anthropic, OpenAI-compatible or local provider behind it. See Connect a model https://github.com/Colton-z/AstraBox/blob/main/docs/models.md . - Team login — Casdoor https://github.com/casdoor/casdoor is pre-integrated as the identity provider: OIDC, organizations and roles, and sign-in through the identity providers an administrator adds in Casdoor, such as Google, Microsoft Entra ID, Okta, GitHub, SAML or LDAP. The installer turns it on with ASTRABOX INSTALL TEAM LOGIN=casdoor , and a clone with one Compose overlay; see Team login https://github.com/Colton-z/AstraBox/blob/main/docs/team-login.md . - Isolated sandboxes — OpenSandbox https://github.com/opensandbox-group/OpenSandbox on one Docker host or a Kubernetes cluster, with warm capacity so conversations start in seconds. - Credentials outside the sandbox — Vault credentials are injected at the sandbox's egress boundary; the Agent only ever sees a placeholder. - Channels and triggers — schedules, signed webhooks and messaging platforms through official Satori https://github.com/satorijs/satori adapters. The astrabox CLI configures and uses a local or remote deployment without the web console. Its results can be printed as JSON, so a coding agent such as Claude Code or Codex can run the same commands for you. - Configuration as code — astrabox init --from-deployment exports a deployment's Environments and Agents to astrabox.yaml ; astrabox diff previews an edit and astrabox apply creates or updates resources, never deleting any. - Tasks from the command line — astrabox run <agent "<task " starts a Session, sends the task and streams the reply; --session continues an existing Session. - Output a program can read — with --output json a command prints one JSON object whether it succeeds or fails, and each kind of failure has its own exit code. - MCP tools — astrabox mcp serve offers schema, get, export, diff, apply, status and run as MCP tools over stdio. - Local or remote — astrabox up , down and logs run the local Compose deployment from a source checkout; the other commands reach any deployment with --endpoint and a bearer token or OAuth client credentials. Install the CLI from a source checkout with make install . Deployments schedule, webhook and messaging triggers and answers to an Agent's questions are managed in the web console or the HTTP API. See the CLI overview https://github.com/Colton-z/AstraBox/blob/main/docs/cli/overview.md . | Agent program | Sandbox image | Used for | |---|---|---| | Claude Code | ghcr.io/colton-z/astrabox-sandbox-claude-code | Agent | | Codex | ghcr.io/colton-z/astrabox-sandbox-codex | Agent | | DeepSeek Harness | ghcr.io/colton-z/astrabox-sandbox-deepseek-harness | Agent | | pi | ghcr.io/colton-z/astrabox-sandbox-pi | Agent | | Hermes Agent | ghcr.io/colton-z/astrabox-sandbox-hermes | Assistant | Other Agent programs can be added with a compatible sandbox image. See Add an Agent program https://github.com/Colton-z/AstraBox/blob/main/docs/writing-an-engine-adapter.md . Each replaceable part of AstraBox is a Python interface with a plugin registration point. An installed package registers its implementation under the matching entry-point group, and AstraBox selects it by name; an unknown name fails with an error instead of falling back to a default. | Extension point | Entry-point group | Built in | |---|---|---| | Agent program | astrabox.providers.engine | Every included Agent program | | Sandbox backend | astrabox.providers.sandbox | OpenSandbox on Docker or Kubernetes | | Model service | astrabox.providers.model | LiteLLM gateway | | Messaging platform | astrabox.providers.channel | Messaging platform gateway, generic JSON webhook | | Identity provider | astrabox.web.identity | Local mode, OIDC, verified JWT, trusted identity headers | | Secret Store | astrabox.providers.secrets | Local encryption, AWS KMS | | Data store | astrabox.providers.repository | PostgreSQL, MongoDB, SQLite | | Workspace storage | astrabox.providers.storage | Mounted volume, Amazon EFS | | Remote MCP server source | astrabox.providers.extensions | Administrator records in AstraBox, LiteLLM MCP gateway | - Interface version — a plugin under astrabox.providers. can set seams api version to the interface version it was built against; AstraBox refuses to load it when that differs from its own. - Conformance suites — astrabox.testing ships reusable test suites for sandbox backends, workspace storage, messaging platforms, Agent programs and data stores; bind one in the plugin's own tests. - Application extensions — entry points for API routes, middleware, lifespan hooks and service implementations extend the application itself. See Add an Agent program https://github.com/Colton-z/AstraBox/blob/main/docs/writing-an-engine-adapter.md , Add a messaging platform https://github.com/Colton-z/AstraBox/blob/main/docs/writing-a-channel-provider.md , Use AstraBox from a Python application https://github.com/Colton-z/AstraBox/blob/main/docs/embedding.md and Extensions https://github.com/Colton-z/AstraBox/blob/main/docs/architecture.md plugin-interfaces . 1. Deploy AstraBox — run the service and OpenSandbox on one Docker host, Kubernetes, or infrastructure you already operate. 2. Configure an Environment — choose the Agent program, sandbox image, model connection, network access, and lifecycle. 3. Create an Agent — select the Environment and model in the web console, then add a system prompt, MCP servers, Plugins, Skills, or a repository only when the Agent needs them. 4. Start a Session — open the Agent and start a Session. 5. Send messages and receive Events — follow live output, answer questions or approvals, and return later without keeping the original browser open. - A Linux host or WSL 2 running Docker Engine 26.0 or later with the Compose plugin 2.17.0 or later, and a user that can use the Docker socket - An API key for a model service: Anthropic, DeepSeek, or another Anthropic- or OpenAI-compatible service Install the latest release with one command: curl -fsSL https://raw.githubusercontent.com/Colton-z/AstraBox/main/scripts/install.sh | bash The installer asks which model service your Agents use, installs the deployment into ~/astrabox , pulls the published images, starts them, and prints the console address once the console answers. Open http://127.0.0.1:8088 http://127.0.0.1:8088 . Select an Environment, create an Agent, and start your first Session from the console. The local deployment listens on loopback and requires no login until you turn on team login, which the installer does with ASTRABOX INSTALL TEAM LOGIN=casdoor . Before exposing it to another network, put it behind an HTTPS proxy as described in Team login https://www.astrabox.ai/docs/team-login put-the-login-flow-behind-a-proxy . Run the installer again to upgrade: it installs the latest release over the current one and keeps your Sessions, credentials and settings. Building the images from a checkout takes longer and is the path for changing AstraBox itself: git clone https://github.com/Colton-z/AstraBox.git cd AstraBox make build-agent-image export ANTHROPIC API KEY="your-anthropic-api-key" export ANTHROPIC MODEL="your-model-name" scripts/compose.sh up --build -d For the complete setup and API alternative, see the Quickstart https://www.astrabox.ai/docs/quickstart . For the installer settings, Kubernetes, or an existing OpenSandbox service, see Deploy AstraBox https://www.astrabox.ai/docs/deploy . Prewarming prepares the Agent runtime before a Session claims it. New Agents have it on in the bundled deployments, and each one holds an idle prepared sandbox; see capacity planning https://github.com/Colton-z/AstraBox/blob/main/docs/deploy.md plan-capacity-for-prepared-sandboxes . Native conversation state is stored in the platform database; a persistent workspace volume is optional and preserves task files separately. For multiple API replicas or sandbox nodes, see distributed deployment https://github.com/Colton-z/AstraBox/blob/main/docs/deploy-distributed.md and workspace storage https://github.com/Colton-z/AstraBox/blob/main/docs/deploy.md where-conversation-workspaces-live . - Long-running asynchronous tasks — let work continue after the developer's computer or browser disconnects. - API integration — use an Agent from an application without building and operating a separate Agent runtime. - Batch processing — run multiple Sessions for independent requests. - Scheduled and event-driven work — start Agents from a schedule, webhook, external system, or messaging platform. Local Agent programs remain the best fit for interactive development on one computer. AstraBox makes the same kind of Agent available remotely and to other systems; the two approaches complement each other. make install make build-agent-image make build-assistant-image make dev Open http://127.0.0.1:5173 http://127.0.0.1:5173 . See CONTRIBUTING.md https://github.com/Colton-z/AstraBox/blob/main/CONTRIBUTING.md for the maintained workflow. Issues and pull requests are welcome. Start with CONTRIBUTING.md https://github.com/Colton-z/AstraBox/blob/main/CONTRIBUTING.md . AstraBox stands on the shoulders of these open-source projects: OpenSandbox https://github.com/opensandbox-group/OpenSandbox , LiteLLM https://github.com/BerriAI/litellm , Casdoor https://github.com/casdoor/casdoor , Satori https://github.com/satorijs/satori , DBOS Transact https://github.com/dbos-inc/dbos-transact-py , mergerfs https://github.com/trapexit/mergerfs , AIO Sandbox https://github.com/agent-infra/sandbox , shadcn/ui https://github.com/shadcn-ui/ui , Vercel AI SDK and AI Elements https://github.com/vercel/ai and Docusaurus https://github.com/facebook/docusaurus — and it runs the Agent programs Codex https://github.com/openai/codex , Hermes Agent https://github.com/NousResearch/hermes-agent , DeepSeek Harness https://github.com/deepseek-ai/deepseek-harness , Pi https://github.com/earendil-works/pi and Claude Code https://github.com/anthropics/claude-code . NOTICE https://github.com/Colton-z/AstraBox/blob/main/NOTICE lists every attribution and license. Apache License 2.0. See LICENSE https://github.com/Colton-z/AstraBox/blob/main/LICENSE . Claude and Claude Code are trademarks of Anthropic; OpenAI and Codex are trademarks of OpenAI. AstraBox is an independent project, not affiliated with or endorsed by them. Claude Code is proprietary software used under Anthropic's terms; see NOTICE https://github.com/Colton-z/AstraBox/blob/main/NOTICE .