selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
agentbox logo

Self-host agentbox

v0.1.18

Self-hosted browser workspace for AI coding agents

BetaOpen SourceApache-2.0
Updated9 hours ago
LanguageGo
Setup difficultyModerate
ThemeDark mode
Stars
254
CPU
2 CPUs per workspace
RAM
2 GiB memory per workspace
Ports
8180 (HTTP web console), 8080 (HTTP web console (code default)), 1080 (abox-link SOCKS5 proxy), 1081 (proxy bridge), 1082 (transparent network control), 1083 (model gateway (when extensions enabled))
Requires
Docker Engine, SQLite
Install with Docker Compose
Chat view with tool calls, Markdown answer with code, turn duration and cost, next-prompt suggestionRunning turn with tool calls, expanded task list, and turn timer/context command drawn as colored grid with categoriesBrowser terminal running type check and tests in persistent tmux sessionGit changes with file list and line-by-line diffFile browser with project folders, edit, upload, downloadRendered Markdown preview of project READMEUsage records per model request with tokens, cache hit rate, cost, latencyAccount pool with Claude and Codex accounts and access scopesClaude skills in workspace and user template

What is agentbox?

agentbox is a self-hosted browser-based workspace for AI-assisted coding. It runs Claude Code and Codex CLI inside Docker containers on your Linux server, providing a persistent environment with a streaming chat interface, a full terminal (tmux-based), file browser with upload/download and rendered previews, and Git integration for diffs, commits, and pull requests. You bring your own server and model subscriptions or API keys; agentbox manages the workspace, account pooling with per-user access scopes, usage tracking with per-request cost and latency, reusable skills and MCP server configurations, and optional private-network tunneling via abox-link. The server is a single Go binary with embedded frontend, using SQLite for state and Docker for workspace isolation. It installs via a one-line script on systemd-based Linux (x86_64/arm64) and listens on port 8180 by default. The project is licensed Apache-2.0 and actively developed.

Should you self-host agentbox?

agentbox scores 45/100 on selfhost.directory (how scoring works) and ranks #66 of 120 in AI Assistant. It has 254 GitHub stars.

It shipped 10 stable releases in the past year. The latest, v0.1.18, came out on 27 October 2026. New versions land roughly every 2 days.

Setup is moderate: expect some configuration beyond a single command. It is Apache-2.0-licensed and written mostly in Go.

Its closest alternative on selfhost.directory is hermes-agent (89/100, 257 885 stars). It scores higher overall, so compare the two before you pick. See agentbox vs hermes-agent side by side.

Features

  • Account pooling with access scopes
  • Background Git operations
  • Browser-based AI coding workspace
  • Cache keepalive for large conversations
  • Claude Skills and MCP servers
  • Extensions system (Loop Guard, Webhooks)
  • File browser with rendered previews
  • Git Integration
  • Multi-language Support
  • Per-request usage and cost tracking
  • Persistent terminal (tmux)
  • Private network tunnel (abox-link)
  • Streaming chat with tool calls
  • Supervisor delegation (preview)Preview feature

agentbox README

How to install agentbox

Install agentbox with Docker Compose

Installs on Linux x86_64/arm64 with systemd and Docker Engine. Ubuntu 22.04+/Debian 12+ auto-install deps via apt. Other distros need Python 3.9+, Git, curl, CA certs, tzdata, Docker pre-installed.

How to configure agentbox

  • agent_imageagentbox-agent:latestDocker image used for workspace containers

    Docker image used for workspace containers

  • auth_tokenInitial admin token, at least 8 chars, no placeholder values

    Initial admin token, at least 8 chars, no placeholder values

  • chat_history_timeout_sec120Timeout for opening workspace, refreshing history, loading older history

    Timeout for opening workspace, refreshing history, loading older history

    values: 1-3600

  • container.cpus2Container CPU limit

    Container CPU limit

    values: > 0

  • container.memory_mb2048Container memory limit in MiB

    Container memory limit in MiB

    values: >= 128

  • container.networkbridgeDocker network mode/name

    Docker network mode/name

    values: non-empty

  • container.pids_limit512Container process limit

    Container process limit

    values: >= 16

  • data_dirdataRoot directory for SQLite, user directories, templates, cache

    Root directory for SQLite, user directories, templates, cache

  • idle_timeout_min30Idle shutdown minutes, 0 to disable

    Idle shutdown minutes, 0 to disable

    values: >= 0

  • listen127.0.0.1:8080HTTP listen address

    HTTP listen address

  • max_upload_mb512Max upload size for projects, files, skills, chat attachments

    Max upload size for projects, files, skills, chat attachments

    values: >= 1

  • permission_modebypassPermissionsClaude headless permission mode

    Claude headless permission mode

    values: default, acceptEdits, plan, bypassPermissions

  • timezoneAsia/ShanghaiIANA timezone for UI times and usage records

    IANA timezone for UI times and usage records

    values: valid IANA timezone

  • tunnel.enabledfalseEnable abox-link private network tunnel

    Enable abox-link private network tunnel

    values: true, false

  • tunnel.network_imageagentbox-network:latestTransparent network helper image

    Transparent network helper image

  • turn_timeout_min120Single conversation turn time limit in minutes

    Single conversation turn time limit in minutes

    values: 5-1440

agentbox releases & version history

More in Container Orchestration

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…