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.

UseAgent logo

Self-host UseAgent

native-runtime-42ef3397fa38

Open-source AI agent workspace for self-hosted coding agents

AlphaOpen SourceAGPL-3.0
Updated9 hours ago
LanguageTypescript
Setup difficultyAdvanced
ThemeDark mode
Stars
372
CPU
4 vCPU
RAM
8 GB RAM
Ports
3201 (backend API and orchestration), 3400 (frontend UI (proxies /api to backend))
Requires
Caddy, PostgreSQL
Docker
ghcr.io/useagenthq/backend
Install with Docker Compose

What is UseAgent?

UseAgent is a self-hosted platform for running AI coding agents in isolated Linux workspaces. It provides a web UI, Slack integration, and REST API to hand off tasks, then streams the agent's work live with terminal, browser, and file views. Every run is stored as an append-only event log in PostgreSQL, so sessions survive restarts and can be replayed. The control plane runs on any Linux host (Ubuntu 24.04) with Docker, bun, Node, and Postgres 16+ with pgvector. Sandboxes are pluggable: Daytona (managed) or CubeSandbox (self-hosted). Authentication uses email/password with optional Google OAuth; production deployments disable self-signup and require admin provisioning. The project is licensed AGPL-3.0 with a commercial license option. It is currently in alpha with APIs subject to change.

Should you self-host UseAgent?

UseAgent scores 47/100 on selfhost.directory (how scoring works) and ranks #123 of 209 in AI Agents. It has 372 GitHub stars.

It shipped 10 stable releases in the past year. The latest, native-runtime-42ef3397fa38, came out on 19 October 2026.

Setup is advanced: plan for several services and some ongoing maintenance. An official Docker image is available. It is AGPL-3.0-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is CORE (52/100, 2 005 stars). It scores higher overall, so compare the two before you pick. See UseAgent vs CORE side by side.

Features

  • Approval gates
  • Artifacts and workpieces
  • Connector framework
  • Event-sourced run log
  • GitHub Integration
  • Isolated Sandboxes
  • Multi-agent Support
  • Organization-scoped tenancy
  • REST API and CLI
  • Scheduled Automations
  • Skills and playbooks
  • Slack integration
  • Team memory and knowledge

UseAgent README

How to install UseAgent

Install UseAgent with Docker Compose

Docker, Docker Compose, Daytona API key or Cube Linux VM

cp deploy/compose/env.example .env.compose

Replace every placeholder and set RELEASE_COMMIT to git rev-parse HEAD.

docker compose --env-file .env.compose -f compose.local.yaml up --build

Local development with disposable PostgreSQL; requires Daytona key or Cube VM

How to configure UseAgent

  • ALLOW_DEV_ORGAllow dev org fallback for anonymous requests

    Allow dev org fallback for anonymous requests

    values: 0, 1

  • BETTER_AUTH_SECRETSecret for Better Auth (at least 32 characters)

    Secret for Better Auth (at least 32 characters)

  • BOOTSTRAP_ADMIN_EMAILEmail for initial admin user bootstrap

    Email for initial admin user bootstrap

  • BOOTSTRAP_ADMIN_PASSWORDPassword for initial admin user bootstrap (min 12 chars)

    Password for initial admin user bootstrap (min 12 chars)

  • DATABASE_URLPostgreSQL connection URL for the main database

    PostgreSQL connection URL for the main database

  • GOOGLE_CLIENT_IDGoogle OAuth client ID for social sign-in

    Google OAuth client ID for social sign-in

  • GOOGLE_CLIENT_SECRETGoogle OAuth client secret for social sign-in

    Google OAuth client secret for social sign-in

  • OPENROUTER_API_KEYAPI key for OpenRouter to access models

    API key for OpenRouter to access models

  • PG_GATEWAY_PASSWORDPostgreSQL password for gateway database user

    PostgreSQL password for gateway database user

  • PG_PASSWORDPostgreSQL password for main database

    PostgreSQL password for main database

  • PUBLIC_ORIGINPublic HTTPS origin for the deployment

    Public HTTPS origin for the deployment

  • SANDBOX_PROVIDERSandbox provider to use (daytona or cube)

    Sandbox provider to use (daytona or cube)

    values: daytona, cube

  • SECRETS_ENCRYPTION_KEYEncryption key for stored secrets (at least 32 characters)

    Encryption key for stored secrets (at least 32 characters)

  • USEAGENT_DEV_MODEfalseEnable development mode (default false)

    Enable development mode (default false)

    values: true, false

  • USEAGENT_OPERATOR_SECRETOperator secret for internal API calls (at least 32 characters)

    Operator secret for internal API calls (at least 32 characters)

UseAgent releases & version history

More in Automation

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…