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
Operant logo

Self-host Operant

Local-first multi-model AI agent for collaborative coding

BetaSource AvailableOther
Updated4 days ago
LanguagePython
Setup difficultyAdvanced
MobilePWA
Stars
447
Port
8000 (Local web UI and API server)
Requires
Python

What is Operant?

Operant is a self-hosted AI agent tool designed for complex programming tasks. It runs entirely on your local machine (macOS arm64 and Linux), providing a web UI, terminal interface (TUI), and a Tauri desktop wrapper. Multiple language models can be assigned distinct roles — planner, coder, reviewer — and collaborate through a structured message-passing system with scoped context. A hierarchical approval system separates clearly allowed actions from those needing human or model-assisted review, with hard denies that cannot be overridden. An experience and memory system captures verified knowledge from past tasks as versioned, scoped skills that can be recalled, reviewed, and shared across projects. The system is extensible via MCP and a local extension package format with six capability categories. All task state, conversations, and artifacts are stored in a local SQLite database. Model calls use your own OpenAI-compatible API endpoints and keys. The project is in beta, distributed as a macOS DMG and source builds, licensed under PolyForm Noncommercial 1.0.0 (source-available, not OSI-approved open source).

Should you self-host Operant?

Operant scores 39/100 on selfhost.directory (how scoring works) and ranks #170 of 209 in AI Agents. It has 447 GitHub stars.

It shipped 1 stable release in the past year. The latest, desktop-candidate-2026-09-28-08e65ea, came out on 28 September 2026.

Setup is advanced: plan for several services and some ongoing maintenance. It is Other-licensed and written mostly in Python.

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

Features

  • Context compression and management
  • File and session references
  • Git-triggered workflows
  • Local-first execution
  • OpenAI-compatible model interface
  • Plugin and extension system
  • Skill discovery and management

Operant README

How to configure Operant

  • OPERANT_API_KEYAPI key for the model service

    API key for the model service

  • OPERANT_BASE_URLhttps://relay.example.comOpenAI-compatible API base URL

    OpenAI-compatible API base URL

  • OPERANT_CODER_MODELModel ID for coder role

    Model ID for coder role

  • OPERANT_PLANNER_MODELModel ID for planner role

    Model ID for planner role

  • OPERANT_REVIEWER_MODELModel ID for reviewer role

    Model ID for reviewer role

Operant releases & version history

More in Code Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…