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.4.2b0.tar.gz
(568.8 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.4.2b0.tar.gz.
File metadata
- Download URL: mambo_agents-0.4.2b0.tar.gz
- Upload date:
- Size: 568.8 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 |
372a361043e51ed9e07f5aaf5fb28e2fcff6f10a757da32c090c8708045164a1
|
|
| MD5 |
648ec7c1371a428701e07aeda0e87a10
|
|
| BLAKE2b-256 |
cd9ad3f2eaf3435ee822ff768835f7072704f15c80e6b6dd0fc3ae49fd5fdd09
|
File details
Details for the file mambo_agents-0.4.2b0-py3-none-any.whl.
File metadata
- Download URL: mambo_agents-0.4.2b0-py3-none-any.whl
- Upload date:
- Size: 234.9 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 |
98f96ebd71326e83060547620ccba7817592c8217cbfe6739dcb3ebd46340bbd
|
|
| MD5 |
951e544babca3def0fb8f01789ae084b
|
|
| BLAKE2b-256 |
907e0246679e96426b55bcd55fef1fbd6435838c47e63f6e38efba3ad5933b72
|
