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.0b2.tar.gz
(561.9 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.0b2.tar.gz.
File metadata
- Download URL: mambo_agents-0.4.0b2.tar.gz
- Upload date:
- Size: 561.9 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 |
6f6ff19890bb5213a40d0a63847ca442be1e784710652e03b95e824b2a675fa6
|
|
| MD5 |
737bd9a8b2410fbd856260a6ae8d4224
|
|
| BLAKE2b-256 |
38d42bdab56303f5bc03b314d65a498e97dc069b553e52659d2b9434a672b899
|
File details
Details for the file mambo_agents-0.4.0b2-py3-none-any.whl.
File metadata
- Download URL: mambo_agents-0.4.0b2-py3-none-any.whl
- Upload date:
- Size: 230.4 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 |
53961df8287e7de1d55b66e5ffe89dbc32ef277b2ed708f4217dde080efaa0ae
|
|
| MD5 |
8c3826d3064d6df20d876d2d3f53e98b
|
|
| BLAKE2b-256 |
933f98ae16a5be86375b7b23e460dee06cfd5a920b6bd204026c18ded8b19799
|
