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
- 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
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.3.0b2.tar.gz
(510.7 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.3.0b2.tar.gz.
File metadata
- Download URL: mambo_agents-0.3.0b2.tar.gz
- Upload date:
- Size: 510.7 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 |
a6df146525830ec73d5a3cc0a42579b254285c2ac3adbe62bcfba2e3856570e7
|
|
| MD5 |
26a747ee305009199fe35fa99dc2eb22
|
|
| BLAKE2b-256 |
fdec7f42755559bba2315b7f424b58410c7de6e1dd0ad5f768a31f84b68e6868
|
File details
Details for the file mambo_agents-0.3.0b2-py3-none-any.whl.
File metadata
- Download URL: mambo_agents-0.3.0b2-py3-none-any.whl
- Upload date:
- Size: 223.8 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 |
d7ec55a66de45338f73facace6022ff4389aae095d693e3691b029ff8a7a0675
|
|
| MD5 |
a7706d38f8ed7c456492617064082773
|
|
| BLAKE2b-256 |
14eb26b73693e0ead32caeb7542d8f8494564a04d9bb90bfb8f78d637b93e3c6
|
