Pre-release
This release is a pre-release and may not be stable for production use.
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
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
1 maintainer
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.2.2b1.tar.gz
(486.3 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mambo_agents-0.2.2b1.tar.gz.
File metadata
- Download URL: mambo_agents-0.2.2b1.tar.gz
- Upload date:
- Size: 486.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.9.14 {"installer":{"name":"uv","version":"0.9.14","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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
012b33eb0715f600c9ee2dbbe028dd0d6cb287402cb6b430573054725679fe4e
|
|
| MD5 |
45a4434694daaf6da372ad8d97ec27a7
|
|
| BLAKE2b-256 |
80af63ff800a5766f49bcf01c1c0e5eb2a8e329ca349084b55ef36a1b2e3cbc8
|
File details
Details for the file mambo_agents-0.2.2b1-py3-none-any.whl.
File metadata
- Download URL: mambo_agents-0.2.2b1-py3-none-any.whl
- Upload date:
- Size: 211.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.9.14 {"installer":{"name":"uv","version":"0.9.14","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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
710fca8fc6d04eea0132fdff22ab88ec721f1d9b269b2e424af666be6f949084
|
|
| MD5 |
f6328c7d29be57478a6237b23f6ccea5
|
|
| BLAKE2b-256 |
fc930f2ad2ea78b12c1738420aa0a7ff06a9fd55278edd51f9c3b25d937272f8
|
