github.com/HKUDS/OpenSpace @main sqlite

<img src="https://github.com/HKUDS/OpenSpace/raw/main/assets/logo.png" width="320px" style="border: none; box-shadow: none;" alt="OpenSpace Logo">

✨ OpenSpace: Make Your Agents: Smarter, Low-Cost, Self-Evolving ✨

| 🔋 46% Fewer Tokens | 💰 $11K earned in 6 Hours | 🧬 Self-Evolving Skills | 🌐 Agents Experience Sharing |

One Command to Evolve All Your AI Agents: OpenClaw, nanobot, Claude Code, Codex, Cursor and etc.

---

📢 News

• 2026-04-16 📊 Evolution candidate lifecycle tracking — skill store now records when evolution suggestions are processed (evolution_processed_at), cleanly distinguishing pending candidates from already-handled ones.
• 2026-04-12 🍎 macOS platform hardening — decoupled atomacos from core macOS imports so screenshots, window control, and recording work independently without it.
• 2026-04-10 🎯 CAPTURED skills now persist to the host agent's own skill directory instead of the default registry path. Cloud skill uploads now support private visibility correctly.
• 2026-04-09 💬 Multi-channel communication gateway. OpenSpace can now receive and respond to messages from external platforms. Ships with WhatsApp (Baileys bridge + QR auth) and Feishu (HTTP webhook) adapters, session management, attachment caching, and allowlist-based access control. See openspace/config/README.md for setup.
• 2026-04-07 🌐 OpenSpace MCP now supports standalone SSE and streamable HTTP startup, making it easier for remote hosts to connect over HTTP instead of stdio and bypass stdio-bound MCP server timeout bottlenecks. See the host integration guide for setup details.
• 2026-04-06 🛠️ Fixed multiple runtime issues across grounding, MCP serving, skill evolution, and persistence, improving execution stability and recovery in long-running workflows.
• 2026-04-05 🧭 Cleaned up LLM credential resolution: centralized .env loading, improved host config auto-detection, and made provider-native env handling more consistent.
• 2026-04-03 🚀 Released v0.1.0 — Skill quality monitoring: structural patterns extracted from high-quality skills now evaluate every new submission daily. Faster, more relevant cloud search. Production-grade vertical skill clusters emerging organically from the community. Frontend now supports Chinese (zh) i18n.
• 2026-04-02 ⚡ Cloud search upgraded for higher relevance and lower latency.
• 2026-03-31 🛡️ Security hardening: hardened zip extraction and import_skill against path traversal. CLI now respects OPENSPACE_MODEL and OPENSPACE_LLM_* env vars; MiniMax compatibility; workflow ID collision fixes.
• 2026-03-29 🔒 Pinned litellm to <1.82.7 to avoid PYSEC-2026-2 supply-chain attack.
• 2026-03-28 🔧 Idempotent skill registration — register_skill_dir now returns existing SkillMeta for already-registered skills. Updated OpenClaw setup docs.
• 2026-03-27 🪟 Fixed stdio deadlock on Windows; improved evolver confirmation parsing with stem-style keyword matching.
• 2026-03-26 🌱 Dynamic skill directory re-scanning on each call, lightweight local skill search, and streamlined documentation.
• 2026-03-25 🎉 OpenSpace is now open source!

---

The Problem with Today's AI Agents

Today's AI agents — OpenClaw, nanobot, Claude Code, Codex, Cursor, etc. — are powerful, but they have a critical weakness: they never Learn, Adapt, and Evolve from real-world experience — let alone Share with each other. - ❌ Massive Token Waste - How to reuse successful task patterns instead of reasoning from scratch and burning tokens every time? - ❌ Repeated Costly Failures - How to share solutions across agents instead of repeating the same costly exploration and mistakes? - ❌ Poor and Unreliable Skills - How to maintain skill reliability as tools and APIs evolve — while ensuring community-contributed skills meet rigorous quality standards?

🎯 What is OpenSpace?

🚀 🚀 The self-evolving engine where every task makes every agent smarter and more cost-efficient.

https://github.com/user-attachments/assets/c50f70ab-f6db-47bf-9498-3210c0f0abae

OpenSpace plugs into any agent as skills and evolves it with three superpowers:

🧬 Self-Evolution

Skills that learn and improve themselves automatically - ✅ AUTO-FIX — When a skill breaks, it fixes itself instantly - ✅ AUTO-IMPROVE — Successful patterns become better skill versions - ✅ AUTO-LEARN — Captures winning workflows from actual usage - ✅ Quality monitoring — Tracks skill performance, error rates, and execution success across all tasks.

Skills that continuously evolve — turning every failure into improvement, every success into optimization.

🌐 Collective Agent Intelligence

Turn individual agents into a shared brain - ✅ Shared evolution: One agent's improvement becomes every agent's upgrade - ✅ Network effects: More agents → richer data → faster evolution for every agent - ✅ Easy sharing — Upload and download evolved skills with one simple command - ✅ Access control — Choose public, private, or team-only access for each skill

One agent learns, all agents benefit — collective intelligence at scale.

💰 Token Efficiency

Smarter agents, dramatically lower costs - ✅ Stop repeating work → Reuse successful solutions instead of starting from zero each time - ✅ Tasks get cheaper → As skills improve, similar work costs less and less - ✅ Small updates only → Fix what's broken, don't rebuild everything - ✅ Real savings: 4.2× better performance with 46% fewer tokens on real-world tasks, delivering measurable economic value. (GDPVal)

Do more, spend less — agents that actually save you money over time.

---

The Difference

❌ Current Agents - Skills degrade silently as tools evolve - Failed patterns repeat with no learning mechanism - Knowledge remains trapped in individual agents

✅ OpenSpace-Powered Agents - Multi-layer monitoring catches problems and auto-triggers repairs - Successful workflows become reusable, shareable skills - When one agent learns something useful, all agents get that knowledge instantly

📊 OpenSpace: Turn Your Agent into a Money-Making Coworker

🎯 Real-World Results That Matter On 50 professional tasks (📈 GDPVal Economic Benchmark) across 6 industries, OpenSpace agents earn 4.2× more money than baseline (ClawWork) agents using the same backbone LLM (Qwen 3.5-Plus). While cutting 46% of costly tokens through skill evolution.

💼 These Aren't Toy Problems - Building payroll calculators from complex union contracts - Preparing tax returns from 15 scattered PDF documents - Drafting legal memoranda on California privacy regulations - Creating compliance forms and engineering specifications

📈 Consistent Wins Across All Fields - Compliance work: +18.5% higher earnings - Engineering projects: +8.7% better performance - Professional documents: 56% fewer tokens needed - Every category improved — no exceptions

OpenSpace doesn't just make agents smarter — it makes them economically viable. Real work, real money, measurable results.

Use Case for Autonomous System Development with OpenSpace

🖥️ My Daily Monitor — OpenSpace empowers your agent to complete large-scale system development. This personal behavior monitoring system with 20+ live dashboard panels was built entirely by the agent — 60+ skills evolved from scratch through OpenSpace, demonstrating autonomous end-to-end software development capabilities.

---

📋 Table of Contents

• ⚡ Quick Start
• 🤖 Path A: For Your Agent
• 👤 Path B: As Your Co-Worker
• 📊 Local Dashboard
• 📈 Benchmark: GDPVal
• 📊 Showcase: My Daily Monitor
• 🏗️ Framework
• 🧬 Self-Evolution Engine
• 🌐 Cloud Skill Community
• 🔧 Advanced Configuration
• 📖 Code Structure
• 🔗 Related Projects

---

⚡ Quick Start

🌐 Just want to explore? Browse community skills, evolution lineage at open-space.cloud — no installation needed.

git clone https://github.com/HKUDS/OpenSpace.git && cd OpenSpace
pip install -e .
openspace-mcp --help   # verify installation

[!TIP] Slow clone? The assets/ folder (~50 MB of images) makes the default clone large. Use this lightweight alternative to skip it: bash git clone --filter=blob:none --sparse https://github.com/HKUDS/OpenSpace.git cd OpenSpace git sparse-checkout set --no-cone '/*' '!/assets/' pip install -e .

Choose your path: - Path A — Plug OpenSpace into your agent - Path B — Use OpenSpace directly as your AI co-worker

🤖 Path A: For Your Agent

Works with any agent that supports skills (SKILL.md) — Claude Code, Codex, OpenClaw, nanobot, etc.

① Add OpenSpace to your agent's MCP config:

{
  "mcpServers": {
    "openspace": {
      "command": "openspace-mcp",
      "toolTimeout": 600,
      "env": {
        "OPENSPACE_HOST_SKILL_DIRS": "/path/to/your/agent/skills",
        "OPENSPACE_WORKSPACE": "/path/to/OpenSpace",
        "OPENSPACE_API_KEY": "sk-xxx (optional, for cloud)"
      }
    }
  }
}

[!TIP] Credentials (API key, model) are auto-detected from your agent's config; you usually don't need to set them manually.

[!NOTE] OpenSpace supports 3 launch modes: - stdio: keep command: "openspace-mcp" in the host config. - SSE: start openspace-mcp --transport sse --host 127.0.0.1 --port 8080. - streamable HTTP: start openspace-mcp --transport streamable-http --host 127.0.0.1 --port 8081.

Common remote endpoints: - SSE endpoint: http://127.0.0.1:8080/sse - streamable HTTP endpoint: http://127.0.0.1:8081/mcp

stdio is the simplest option. HTTP modes keep OpenSpace as a standalone server, but host-specific registration syntax and host-side timeouts still apply.

② Copy skills into your agent's skills directory:

cp -r OpenSpace/openspace/host_skills/delegate-task/ /path/to/your/agent/skills/
cp -r OpenSpace/openspace/host_skills/skill-discovery/ /path/to/your/agent/skills/

Done. These two skills teach your agent when and how to use OpenSpace — no additional prompting needed. Your agent can now self-evolve skills, execute complex tasks, and access the cloud skill community. You can also add your own custom skills — see openspace/skills/README.md.

[!NOTE] Cloud community (optional): Register at open-space.cloud to get a OPENSPACE_API_KEY, then add it to the env block above. Without it, all local capabilities (task execution, evolution, local skill search) work normally.

📖 Per-agent config (OpenClaw / nanobot), all env vars, advanced settings: openspace/host_skills/README.md

👤 Path B: As Your Co-Worker

Use OpenSpace directly — coding, search, tool use, and more — with self-evolving skills and cloud community built in.

[!NOTE] Create a .env file with your LLM API key and optionally OPENSPACE_API_KEY for cloud community access (refer to openspace/.env.example).

# Interactive mode
openspace

# Execute task
openspace --model "anthropic/claude-sonnet-4-5" --query "Create a monitoring dashboard for my Docker containers"

Add your own custom skills: openspace/skills/README.md.

Cloud CLI — manage skills from the command line:

openspace-download-skill <skill_id>         # download a skill from the cloud
openspace-upload-skill /path/to/skill/dir   # upload a skill to the cloud

Python API

```python import asyncio from openspace import OpenSpace

async def main(): async with OpenSpace() as cs: result = await cs.execute("Analyze GitHub trending repos and create a report") print(result["response"])

    for skill in result.get("evolved_skills