Mambo Agents

AI Agent framework built on LangChain/LangGraph — multi-backend filesystem, sub-agent parallel scheduling, conversation summarization, security review, skills system, and more, out of the box.
基于 LangChain/LangGraph 的 AI Agent 框架 — 提供多后端文件系统、子代理并行调度、对话摘要、安全审查、技能系统等开箱即用的能力。

📖 English | 中文

This project draws architectural inspiration from deepagents, with independent refactoring and extensions. See comparison with deepagents.

Key Features

Let Your Agent Control the Environment — multi-backend filesystem (virtual/local/SSH/hybrid), with shell command execution
Long Conversation Management — automatic conversation history compaction with chained summaries
Task Planning & Tracking — structured TODO lists with automatic progress tracking
Installing Skill Packs — progressive disclosure, on-demand loading, multi-source overlay
Let Your Agent Remember Your Preferences — AGENTS.md persistent context, AI self-learning write-back
Security & Human Approval — cheap model pre-review + human approval for high-risk operations
File Change History & Rollback — checkpoint-level incremental snapshots, manual rollback
Integrating External MCP Tools — disclosure-based design, on-demand lookup
Multi-Agent Collaboration — sync/async sub-agents, parallel scheduling, isolated context windows
Goal-Driven Loop Control — preset goals with completion conditions, or LLM-autonomous long-running tasks with auto-continuation

Quick Start

pip install mambo-agents

from mambo_agents import create_mambo_agent, StoreBackend
from langchain_core.messages import HumanMessage

agent = create_mambo_agent(
    "gpt-4o",
    backend=StoreBackend(),
    include_general_purpose=True,
)
result = agent.invoke({"messages": [HumanMessage("Create a hello.py file")]}, config={"configurable": {"thread_id": "session-1"}})

Architecture

┌──────────────────────────────────────────────────────────┐
│                    create_mambo_agent()                   │
│                                                          │
│  ┌─────────────┐  ┌──────────┐  ┌────────────────────┐  │
│  │   Backend   │  │  Model   │  │    Middleware Stack │  │
│  │  Protocol   │  │ (LLM)    │  │                    │  │
│  │  Store      │  │          │  │ BackendTools       │  │
│  │  Local      │  │          │  │ Skills             │  │
│  │  SSH        │  │          │  │ Memory             │  │
│  │  Hybrid     │  │          │  │ VersionControl     │  │
│  │  ReadOnly   │  │          │  │ Summarization      │  │
│  │             │  │          │  │ Planning           │  │
│  └─────────────┘  └──────────┘  │ SubAgents          │  │
│                                 │ AsyncSubAgents     │  │
│                                 │ SecurityReview     │  │
│                                 │ Patch + Reorder    │  │
│                                 └────────────────────┘  │
│                                                          │
│  ┌─────────────────────────────────────────────────────┐ │
│  │              LangGraph CompiledGraph                │ │
│  │  invoke() · astream() · astream_events()            │ │
│  └─────────────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────────────┘

Docs

Detailed Usage Guide — API reference, configuration, advanced usage
Comparison with deepagents — architectural differences, feature mapping, design trade-offs

Related Projects

MamboChat — Full-featured Web UI built on Mambo Agents

License

MIT License

Download files

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

Source Distribution

mambo_agents-0.3.0b4.tar.gz (517.6 kB view details)

Uploaded Aug 23, 2026 Source

Built Distribution

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

mambo_agents-0.3.0b4-py3-none-any.whl (226.3 kB view details)

Uploaded Aug 23, 2026 Python 3

File details

Details for the file mambo_agents-0.3.0b4.tar.gz.

File metadata

Download URL: mambo_agents-0.3.0b4.tar.gz
Upload date: Aug 23, 2026
Size: 517.6 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.9.15 {"installer":{"name":"uv","version":"0.9.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for mambo_agents-0.3.0b4.tar.gz
Algorithm	Hash digest
SHA256	`6d846aa99bebf598fdc36f485cc4a521329f838bd3c78434d5bee1574718e354`
MD5	`e9e0f8617194b431ef79bd2b7210c0c2`
BLAKE2b-256	`c21eea5ea5e64d9f9cef8811f75e7b8d375aaa2465c93ad5c4dc5f934f281e1b`

See more details on using hashes here.

File details

Details for the file mambo_agents-0.3.0b4-py3-none-any.whl.

File metadata

Download URL: mambo_agents-0.3.0b4-py3-none-any.whl
Upload date: Aug 23, 2026
Size: 226.3 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.9.15 {"installer":{"name":"uv","version":"0.9.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for mambo_agents-0.3.0b4-py3-none-any.whl
Algorithm	Hash digest
SHA256	`71627c3599895c0509e7ba92f5023ff58481e2f5966b641ca5a3ff0ca663885a`
MD5	`9a4aa852ff9403fd2ee9884d88f45e14`
BLAKE2b-256	`c136cb978fb0052d337a39df0adee14318937963cd4fe062e3225d80de73ef05`