Skip to main content

Self-hosted AI agents — streaming chat, tool use, persistent memory, multi-agent teams

Project description

OpenAgentd

OpenAgentd

Apache 2.0 Python 3.14 React 19

A local-first cockpit for AI agents.
Run an agent team on your machine, see every tool call and diff, and keep your models, sessions, workspaces, and telemetry under your control.

Get started · Features · Issues · Contribute

OpenAgentd annotated multi-agent cockpit

Why OpenAgentd

Most coding agents live in a terminal or an editor. OpenAgentd is the cockpit around them: a native desktop app and mobile companion where you can run a lead with specialists, follow work in real time, inspect what changed, and keep moving without losing context.

  • See the work. Streamed replies, tool calls, arguments, results, timings, files, diffs, terminal output, and agent status are visible in one interface.
  • Run a team. A lead can delegate to specialists, coordinate them through an async mailbox, and let you watch individual or unified timelines.
  • Work in real repositories. Coding sessions open local folders, support isolated git worktrees, show changes and history, and return language-server diagnostics after edits.
  • Choose your models. Use your own keys with major cloud and local providers, including Anthropic, OpenAI, Gemini, OpenRouter, Bedrock, Copilot, Codex, Ollama, and more.
  • Stay local-first. Sessions, telemetry, configuration, and the API server run on your machine. Connect a mobile client or another desktop securely when you need to.

The versioned feature catalogue is the canonical record of shipped capabilities.

Get started

Desktop app

Install the current desktop release:

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/lthoangg/openagentd/main/install.sh | sh
# Windows PowerShell
irm https://raw.githubusercontent.com/lthoangg/openagentd/main/install.ps1 | iex

Open OpenAgentd from your applications folder or Start menu. The desktop app runs its bundled backend automatically; add a provider in Settings and start a conversation.

Release artifacts are available for macOS, Windows, and Linux on the latest release page. Unsigned desktop builds may require an explicit operating-system confirmation before first launch.

CLI server

Install the backend when you want to run it from a terminal, use a browser client, or connect another device:

uv tool install openagentd
openagentd

The server creates its default agents and configuration on first start. Open the printed local address and add a provider in Settings. For a phone or another computer on your network:

openagentd start --lan --key
openagentd address
openagentd health

--key protects non-loopback access. Use openagentd --help and <command> --help for the current command reference.

From source

git clone https://github.com/lthoangg/openagentd.git
cd openagentd
uv sync
bun install --cwd web
make run

For frontend development in a second terminal:

cd web && bun dev

What it feels like

A conversation that can act A workspace that stays in view
Split cockpit view with lead and worker agents Coding workspace with files and diffs
Inspect changes Keep an eye on local usage
Inline diff inspector Telemetry summary

Built for the whole loop

Plan and delegate. Ask for a plan before code changes, then let a lead split independent work across specialists. View the unified timeline when you want the story, or focus on one agent when you need detail.

Build and inspect. Attach files, browse a coding workspace, use @ mentions, run a direct shell command with !command, review a diff, and inspect structured tool output without leaving the conversation.

Operate with confidence. Manage providers, MCP servers, skills, sandbox permissions, scheduled tasks, todos, and local telemetry from the cockpit. OpenAgentd supports desktop, browser, and touch-first mobile clients against the same API.

For users and contributors

  • Features — shipped, version-cited capabilities.
  • Releases — download builds and read release notes.
  • Issues — feature requests, bugs, roadmap discussion, and known issues.
  • Security policy — report vulnerabilities privately.
  • Contributing — set up a development checkout and submit changes.

OpenAgentd is licensed under Apache 2.0.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

openagentd-1.119.0.tar.gz (16.7 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

openagentd-1.119.0-py3-none-any.whl (679.2 kB view details)

Uploaded Python 3

File details

Details for the file openagentd-1.119.0.tar.gz.

File metadata

  • Download URL: openagentd-1.119.0.tar.gz
  • Upload date:
  • Size: 16.7 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for openagentd-1.119.0.tar.gz
Algorithm Hash digest
SHA256 e046bead4e42b433378cb7c01a8782d7516ed5916b64005a7e649e35015f17fe
MD5 2b3b1a343adaf4642e7d0bc2c8f5ec44
BLAKE2b-256 07c5f4e22d269bc2afbe00d5ef22ed6d99cc82e0c63ebbd2a9fba5fe42897b4a

See more details on using hashes here.

File details

Details for the file openagentd-1.119.0-py3-none-any.whl.

File metadata

  • Download URL: openagentd-1.119.0-py3-none-any.whl
  • Upload date:
  • Size: 679.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for openagentd-1.119.0-py3-none-any.whl
Algorithm Hash digest
SHA256 05789032e123c3264a558a0aa5c655a7043faffdb06548ef9c38b2792aae7e12
MD5 84912c2fe44e791caf0a0fd0612f2842
BLAKE2b-256 61b9a4462725914d7837007e20eb2e35ffec409251eb54e4d402f85d1057d005

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page