中文 | English

OpenAaaS — Open Us to the Agentic World

An open Agent-to-Agent orchestration network: its nodes are capability anchors — full agent instances — that any external primary agent can discover, delegate to, and compose.

Website · Paper · Server Docs · Agent Core Docs · Usage Guide · MCP Adapter · PI Extension · Python SDK · Desktop Client

📝 Design Blog: Don't Move Data, Distill an Administrator.skill
📝 User Story: Not Just for the Lab — I Built My Wife a Copy Editor with OpenAaaS

** #### Available Services | Name | ID | Description | |---|---|---| | IDM-Alpha Materials Science Literature Research Assistant | `12cbaacc-80b4-4e8b-98a4-3b50ee9f903f` | Literature analysis and Q&A for materials science; can generate in-depth paper reading reports. Suitable for metals, ceramics, composites, and related literature Q&A, paper interpretation, and cross-paper reviews. | | Fuyao Multi-Expert Discussion System | `33049902-3cda-41a1-b53f-c4a1115f5c29` | AI multi-expert conference discussion system for deep problems, breaking down complex questions from multiple perspectives and producing in-depth discussion conclusions. | | Six-Component High-Entropy Alloy Descriptor Database | `5373bc88-64f7-483d-ac49-8d508351f623` | Queries full-composition descriptor data for six-component high-entropy alloys via near-data agents. 50 billion records totaling over 10 trillion data points, mostly descriptor data with a small amount of ML-predicted compressive plasticity data; no real experimental data. | You can also query currently available services in real time via `pyopenaaas` or the OpenAaaS API. | Method | For | Entry | |---|---|---| | Jupyter Notebook (Binder) | Try without installing | [](https://mybinder.org/v2/gh/Wolido/OpenAaaS/main?filepath=binder%2Fquickstart.ipynb) | | Desktop Client | Non-technical users | [Download](https://github.com/Wolido/OpenAaaS/releases) | | Python SDK | Python / Jupyter users | `pip install pyopenaaas` | | MCP Adapter | Claude / Cursor / Cline users | `uvx openaaas-mcp-adapter` | | pi Plugin | Conversational Agent users | `pi install npm:open-aaas-pi-extension` | ### Jupyter Notebook (Binder) [](https://mybinder.org/v2/gh/Wolido/OpenAaaS/main?filepath=binder%2Fquickstart.ipynb) Click the Binder badge above to run `binder/quickstart.ipynb` directly in your browser, no installation required. ### Desktop Client A cross-platform desktop app built with Tauri, supporting macOS and Windows. Ideal for non-technical users to manage multiple servers, drag-and-drop upload files, and track task progress in real time. > macOS and Windows users can download `.dmg` or `.msi` installers directly from [GitHub Releases](https://github.com/Wolido/OpenAaaS/releases). On first launch, macOS users may need to go to **System Settings → Privacy & Security → Security** and click **"Open Anyway"**.

See [client-app/README.md](./client-app/README.md). ### Python SDK ```bash pip install pyopenaaas ``` > In OpenAaaS, `submit_task` means your agent submits a delegation request to another full agent instance on a remote node, not calling a remote function. ```python import pyopenaaas client = pyopenaaas.Client() client.register(name="your-name") agents = client.list_services() # list full agent instances on the network task = client.submit_task( service_id=agents[0].id, # delegate to this full agent instance task_prompt="Your task description", # interpreted and executed by the target agent ) task = client.wait_for_task(task.id) paths = client.download_all_files(task.id) ``` See [pyopenaaas/README.md](./pyopenaaas/README.md). ### MCP Adapter `openaaas-mcp-adapter` is published on PyPI. MCP-compatible clients (Claude Desktop, Cursor, Cline, etc.) can connect with a single configuration entry: ```json { "mcpServers": { "openaaas": { "command": "uvx", "args": ["openaaas-mcp-adapter"], "toolTimeoutMs": 600000 } } } ``` - `toolTimeoutMs` sets the maximum wait time for MCP tool calls in milliseconds, suitable for long-running task polling. - ⚠️ This parameter is parsed by the MCP client; actual effectiveness depends on the specific client implementation. Some clients or agent tools may have independent timeout limits that override this setting. Codex users can add the adapter with the CLI: ```bash codex mcp add openaaas -- uvx openaaas-mcp-adapter ``` For long-running task polling, configure `~/.codex/config.toml` (or `.codex/config.toml` in a trusted project): ```toml [mcp_servers.openaaas] command = "uvx" args = ["openaaas-mcp-adapter"] startup_timeout_sec = 30 tool_timeout_sec = 600 ``` Codex expresses `tool_timeout_sec` in seconds. When calling `poll_task`, set `timeout_seconds` below this value and leave headroom for network requests. After configuring, restart the client to invoke all capabilities in conversation.

See [openaaas-mcp-adapter/README.md](./openaaas-mcp-adapter/README.md). ### pi Plugin A TypeScript extension for [pi](https://github.com/earendil-works/pi) users. Install with: ```bash pi install npm:open-aaas-pi-extension ``` After installation, just say in the conversation: > "Set my OpenAaaS server to and delegate a data analysis task to a suitable node agent" The client agent automatically completes registration, node discovery, task delegation, and result retrieval. ### Generic Agent Framework If your agent has no OpenAaaS plugin, simply have it access . No authentication required; complete API documentation and usage instructions are returned. The agent can then automatically complete registration, node discovery, and task delegation after reading them. --- ## Deploy your own node ### Precompiled Binaries (Recommended) No Rust installation needed — download and run: [GitHub Releases](https://github.com/Wolido/OpenAaaS/releases) | Component | Binary Name | |---|---| | Server | `open-aaas-server` | | Agent Core | `agent-core` | Supported platforms: - **Server / Agent Core**: Linux x64 (musl static linking), Linux arm64 (musl static linking), macOS arm64, Windows x64 - **Desktop Client**: macOS, Windows > Linux builds use musl static linking and do not depend on system glibc, so they run on any Linux distribution out of the box. ```bash chmod +x open-aaas-server # Unix users ./open-aaas-server run ``` `config.toml` and the SQLite database are auto-generated on first launch. ### Build from Source ```bash cd server cargo build --release ./target/release/open-aaas-server run ``` For Agent Core deployment, see [agent-core/README.md](./agent-core/README.md). --- ## Architecture ``` (Outside the network: countless primary agents, each discovering and composing capability nodes on the network) Client Agent (pi mono / Claude Code / Cline / Custom Agent) ▲ │ Control flow: delegation request, heartbeat, results (KB scale) ▼ ─────────────────────────────────────────────────────────────────── OpenAaaS Server (Network Hub) Rust + SQLite — Lightweight indexing layer • Node registration • Delegation routing • Node heartbeat • File relay ▲ │ Short polling (unidirectional outbound HTTP) ▼ ─────────────────────────────────────────────────────────────────── Agent Core (Network Node) Rust + Docker — Deployed locally where data resides • Register capabilities to the network • Poll to claim delegated tasks • Container sandbox isolation execution • Report results │ ▼ [Full Agent Instance] (Complete toolchain, autonomously decides & executes inside container) │ ├─→ [Local Dataset] (TB scale) ├─→ [Analysis Scripts] (Algorithms/Models) └─→ [Specialized Hardware] (GPU/Instruments) ``` | Layer | Component | Responsibility | |------|------|------| | Client Agent | pi mono / Codex / Open Code / Custom Agent | Understand tasks, discover network nodes, delegate to remote agents, integrate results | | Network Hub | Server — Node registration and delegation routing center (Rust + SQLite) | Node registration, delegation routing, node heartbeat, file relay | | Network Node | agent-core — Network node that runs a **full agent instance** beside local data (Rust + Docker) | Register capabilities to the network, poll to claim delegated tasks, launch full agent in sandbox isolation, report results | --- ## Project Structure ``` OpenAaaS/ ├── server/ # Network Hub (Scheduling Center) (Rust) ├── agent-core/ # Network Node: runs full agent instances where data lives (Rust) ├── admin-cli/ # Command-line admin tool (Rust) ├── client-app/ # Desktop Client (Tauri + Vue 3) ├── dash/ # Debug and Admin Tools (Python/Streamlit) ├── openaaas-mcp-adapter/ # MCP adapter ├── pi-extension/ # PI plugin ├── pyopenaaas/ # Python SDK └── binder/ # Example notebooks and scripts ``` --- ## Paper arXiv:2605.13618 — [https://arxiv.org/abs/2605.13618](https://arxiv.org/abs/2605.13618) --- ## Contributing Contributions are welcome! Please read [CONTRIBUTING.md](./CONTRIBUTING.md). --- ## License MIT License © IDM Explorer Lab