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.1b2.tar.gz
(485.0 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.1b2.tar.gz.
File metadata
- Download URL: mambo_agents-0.2.1b2.tar.gz
- Upload date:
- Size: 485.0 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 |
6147913ef30e73055dd85d0fbd60590755ef6f70ca38e4b2607b1cd49a2c958a
|
|
| MD5 |
c5238e178ff897dd76f5958dea3b90a8
|
|
| BLAKE2b-256 |
ba5748e8832e03d0d38ed6c563f6706385009848cff4ed56501ed44cde3f8d54
|
File details
Details for the file mambo_agents-0.2.1b2-py3-none-any.whl.
File metadata
- Download URL: mambo_agents-0.2.1b2-py3-none-any.whl
- Upload date:
- Size: 211.1 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 |
fdfa6fceb0e4eced912dd496955cfad25b1f4b6878b685c6c646c583371b83ca
|
|
| MD5 |
26fd12306b6eb673f8afbe91a18c961c
|
|
| BLAKE2b-256 |
43ea68016cfd50aaf344d61cd3c8370e0ec2146736be41cb33d7fd25ea9ed3eb
|
