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.

Oh My Subagents logo

Self-host Oh My Subagents

v0.3.2

Local AI agent orchestration for Codex and Claude

BetaOpen CoreMIT
Updatedlast month
LanguagePython
Setup difficultyModerate
Stars
190
Port
18125 (Web console and HTTP API)
Install with pip
How Oh My Subagents delegates work, persists a parent wait, and collects the complete team's returns

What is Oh My Subagents?

This tool runs AI subagents from Codex and Claude on your own machine. Instead of manually spawning temporary agents, you build reusable workflows as responsibility trees, publish stable versions, and assign a lead agent a specific mission. The controller saves every delegation, wait, and returned checkpoint so that closing the browser, provider interruptions, or controller restarts never lose accepted work. A visual console displays the live team, current plans, activity, human requests, and the final result with links to workspace files. A separate conversational operator provides the same operations through chat. SQLite works out of the box with no external server; PostgreSQL is optional. The core uses MIT licensing while the console uses the Sustainable Use License from n8n.

Should you self-host Oh My Subagents?

Oh My Subagents scores 43/100 on selfhost.directory (how scoring works) and ranks #153 of 209 in AI Agents. It has 190 GitHub stars.

It shipped 10 stable releases in the past year. The latest, v0.3.2, came out on 30 August 2026. New versions land roughly every 3 days.

Setup is moderate: expect some configuration beyond a single command. It is MIT-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is Orca (91/100, 108 815 stars). It scores higher overall, so compare the two before you pick. See Oh My Subagents vs Orca side by side.

Features

  • Accountable result
  • Adaptive execution patterns
  • Background service
  • Capability-based security
  • CLI automation
  • Conversational Operator
  • Durable task state persistence
  • HTTP API
  • Interruption recovery
  • Reusable workflow definitions
  • Run studio with live activity
  • Starter workflows
  • Steering
  • Visual workflow studio
  • Workspace file references

Oh My Subagents README

How to install Oh My Subagents

Install Oh My Subagents with pip

Environment variables
OMS_CONFIG, OMS_DATA_DIR, OMS_DATABASE_URL, OMS_POSTGRES_SCHEMA, OMS_CONTROLLER_WORKSPACE, OMS_API_HOST, OMS_API_PORT, OMS_CONSOLE_ORIGINS, OMS_LOG_LEVEL, OMS_DEBUG, OMS_DATABASE_ECHO, OMS_SUPPORT_BEARER_TOKEN

pipx install oh-my-subagents oms init oms service install

Installs in isolated environment; guided initialization configures workspace, provider, and starter workflows

How to configure Oh My Subagents

  • console_originshttp://127.0.0.1:5173, http://localhost:5173, http://127.0.0.1:4173, http://localhost:4173Allowed console origins

    Allowed console origins

  • data_dirPlatform data directory

    Platform data directory

  • default_providerDefault task provider

    Default task provider

    values: codex, claude

  • dispatch_launch_retry_initial_backoff_seconds1.0Initial retry delay for provider launch

    Initial retry delay for provider launch

  • dispatch_launch_retry_max_backoff_seconds30.0Maximum provider-launch retry delay

    Maximum provider-launch retry delay

  • echofalseDatabase echo mode

    Database echo mode

  • efforthighCodex effort level

    Codex effort level

    values: high, max

  • enabledtrueEnable Codex provider

    Enable Codex provider

  • extension_modeinheritCodex extension mode

    Codex extension mode

    values: inherit, isolated

  • host127.0.0.1Server bind host

    Server bind host

    values: loopback IPs only

  • levelWARNINGLogging level

    Logging level

  • managed_provider_network_accessallowController ceiling for network access

    Controller ceiling for network access

    values: deny, allow

  • managed_provider_sandbox_modefull_accessController ceiling for sandbox mode

    Controller ceiling for sandbox mode

    values: read_only, workspace_write, full_access

  • max_child_assignments_per_assignment20Max child assignments per assignment

    Max child assignments per assignment

  • max_retries_per_assignment1Semantic retry budget per assignment

    Semantic retry budget per assignment

  • max_wave_members8Max members in one delegation wave

    Max members in one delegation wave

  • modelgpt-5.6Codex model

    Codex model

  • OMS_API_HOST127.0.0.1Server bind host (loopback only)

    Server bind host (loopback only)

    values: 127.0.0.1, ::1, localhost

  • OMS_API_PORT18125Server port

    Server port

  • OMS_CONFIGPath to configuration TOML file

    Path to configuration TOML file

  • OMS_CONSOLE_ORIGINSAllowed console origins

    Allowed console origins

  • OMS_CONTROLLER_WORKSPACEDefault workspace directory

    Default workspace directory

  • OMS_DATABASE_ECHODatabase echo mode

    Database echo mode

    values: 1|true|yes|on / 0|false|no|off

  • OMS_DATABASE_URLSQLAlchemy database URL

    SQLAlchemy database URL

  • OMS_DATA_DIRData directory path

    Data directory path

  • OMS_DEBUGDebug mode

    Debug mode

    values: 1|true|yes|on / 0|false|no|off

  • OMS_LOG_LEVELWARNINGLogging level

    Logging level

  • OMS_POSTGRES_SCHEMAPostgreSQL schema name

    PostgreSQL schema name

  • OMS_SUPPORT_BEARER_TOKENSupport API bearer token (32+ chars)

    Support API bearer token (32+ chars)

  • operator.providerOperator provider

    Operator provider

    values: codex, claude

  • port18125Server port

    Server port

  • postgres_schemaomsPostgreSQL schema name

    PostgreSQL schema name

  • providerOperator provider

    Operator provider

    values: codex, claude

  • runtime.default_providerDefault task provider

    Default task provider

    values: codex, claude

  • urlsqlite+aiosqlite:///<data_dir>/oms.persistenceSQLAlchemy database URL

    SQLAlchemy database URL

  • watchdog_inactivity_timeout_seconds2700Inactivity duration before watchdog handling

    Inactivity duration before watchdog handling

  • watchdog_same_attempt_replacement_limit2Same-attempt watchdog replacements

    Same-attempt watchdog replacements

  • workspaceDefault workspace directory

    Default workspace directory

Oh My Subagents releases & version history

More in AI Automation

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…