pyagentmesh 0.0.2

Orchestration Framework for Multi-Agent and Micro-Agent

🚀 Epsilla AgentMesh

Epsilla AgentMesh is an open-source governance and orchestration framework for multi-agent and micro-agent, inspired by service mesh architecture, designed to help you build, scale, and manage powerful AI agent systems with unified communication, policy control, and observability.

---

🌟 Key Features

✅ Communication Proxy
Seamlessly route messages between agents using multiple protocols (MCP, HTTP, gRPC), with built-in retries, timeouts, and prioritization.

✅ Policy & Configuration Control
Define and enforce access, rate limits, circuit breaking, and task routing policies from a central control plane.

✅ Observability
Gain full visibility into multi-agent interactions with tracing, metrics, dashboards, and alerting.

✅ Scalable & Resilient
Support for load balancing, auto-scaling, failover routing, and dynamic agent registration.

✅ Security & Identity
Mutual authentication, encrypted messaging, and fine-grained role-based access across agent systems.

✅ Flexible Deployment
Run as sidecars, centralized proxies, or lightweight agents — on Kubernetes, cloud, or on-prem.

---

📐 Architecture

Core components:

• Communication Proxy: Message routing & protocol handling.
• Policy & Configuration: Define control rules & dynamic updates.
• Observability Module: Collect, visualize, and monitor agent system performance.

---

🔧 Getting Started

1️⃣ Install

git clone https://github.com/epsilla-cloud/AgentMesh.git
cd AgentMesh
pip install -r requirements.txt

2️⃣ Run Example Demo

python examples/run_demo.py

3️⃣ Launch Dashboard (Optional)

streamlit run dashboard/app.py

---

💡 Example Use Cases

• Multi-agent RAG systems for document analysis
• Autonomous multi-agent negotiation systems
• Large-scale agent-based simulation platforms

---

🔍 Roadmap

• ✅ Initial open-source release
• 🔄 Integration with AutoGen, LangGraph, CrewAI
• 🔐 Federated cross-org agent mesh support
• 🛠️ Visual orchestration editor for human-in-the-loop control
• 🤖 AI-driven policy tuning & optimization

---

🤝 Contributing

We welcome contributions! Please check out the CONTRIBUTING.md for details on how to get started.

---

📄 License

This project is licensed under the Apache 2.0 License — see the LICENSE file for details.

---

🔗 Links

• Website: https://epsilla.com
• Docs: ./docs
• Community: Discord

---

Note: AgentMesh is a reference implementation and experimental platform by the Epsilla team to explore next-generation agent governance patterns. We are excited to evolve this together with the open-source community!

---

📥 CONTRIBUTING.md

Thank you for considering contributing to AgentMesh! Here’s how you can help:

📦 Reporting Issues

• Use the GitHub Issues tab to report bugs or request features.

🔨 Submitting Pull Requests

• Fork the repository.
• Create a feature branch.
• Submit a clear pull request with a description of your changes.

🛠 Development Setup

• Clone the repo and install dependencies.
• Follow the coding style and run tests before submitting PRs.

---

📜 LICENSE

Apache License 2.0

Copyright (c) 2025 Epsilla

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

---

🧪 Example Demo Script (examples/run_demo.py)

# examples/run_demo.py

from AgentMesh import AgentMesh, Agent

# Define example agents
agent_a = Agent(name="AgentA", capabilities=["task1", "task2"])
agent_b = Agent(name="AgentB", capabilities=["task3"])

# Initialize mesh
mesh = AgentMesh()
mesh.register(agent_a)
mesh.register(agent_b)

# Simulate a task
result = mesh.send_task(from_agent="AgentA", to_agent="AgentB", task="task3", payload={"data": "demo"})
print("Task result:", result)

---

Let me know if you need full starter code or prebuilt dashboard templates!