OpenOctopus

Run one AI agent server and let it work in Server Workspaces or on paired Linux, macOS, and Windows computers.

OpenOctopus is an alpha/demo release. Its Client can run commands and local MCP services with the permissions of your operating-system user. Read Security and current boundaries before exposing a Server or pairing a computer.

What it does

• Serves a browser UI and API from the same Docker image.
• Stores durable users, conversations, configuration, and MCP catalogs in PostgreSQL, with Server Workspace files in RustFS.
• Provides personal and equal-permission shared Workspaces, file management, browser attachments, and transfers between the Server and paired computers.
• Routes file tools and web_fetch to the Server or a selected Client.
• Runs pipe commands and line-oriented PTY/ConPTY sessions on paired Clients.
• Connects admin-managed Server MCP and per-device MCP over stdio, Streamable HTTP, or SSE, including tools, resources, templates, and prompts.
• Connects one Discord Bot and one DingTalk Bot per user to the same durable conversation and Agent loop as the browser.
• Uses native Pydantic AI Providers for Anthropic Messages, OpenAI-compatible Chat Completions, and OpenRouter.
• Runs the Pydantic AI Harness with durable DBOS main and background child agents.
• Ships six read-only built-in skill guides, available to every agent and in Workspace.
• Runs scheduled jobs and Jev-gated Heartbeat checks. Dream reviews completed days' conversation text and updates the official Memory store, with change history and undo in Automations.

New accounts receive an editable SOUL.md file in their personal Workspace. The Memory page edits the same versioned PostgreSQL notes used by agents and Dream. Administrators can configure the default SOUL, Provider, Workspace quotas, Jev decision service, Server Web Fetch policy, users, and shared Server MCP from the UI.

See it in action

Server Workspace

Browse the Server Workspace alongside paired Clients, then manage files and agent instructions in one place.

Paired Clients

Pair a computer once, see whether it is online, and route the Agent to its Workspace, commands, and MCP services.

External Channels

Connect a personal Discord or DingTalk Bot to the same durable conversation as the browser, with owner pairing and an explicit text-only allow list.

Architecture

Browser
  | REST + best-effort NDJSON stream
  v
OpenOctopus Server (one ASGI worker)
  |-- PostgreSQL: users, conversations, configuration, MCP catalogs
  |-- RustFS: Server Workspaces and uploaded attachments
  |-- Pydantic AI Harness + native model Providers + DBOS recovery
  |-- Jev decision API for Heartbeat Phase 1 and Dream
  |-- Discord Gateway + REST adapter
  |-- DingTalk Stream + OpenAPI adapter
  |-- Admin-installed Server MCP services with conversation-owned clients
  `-- Protocol v3 WebSocket
        `-- OpenOctopus Client
              |-- local file tools and transfers
              |-- exec: pipes + POSIX PTY / Windows ConPTY
              |-- Client web_fetch
              `-- Device MCP runtimes