LeafMesh — Multi-Agent AI Orchestration Platform
YAML-native multi-agent AI platform with self-healing and evolutionary capabilities
LeafMesh transforms multi-agent AI development through declarative YAML configuration that becomes executable intelligence. Built on the MANAGED_MESH architecture with production-ready coordination and persistence.
Core Features
- YAML-Native Intelligence - Zero-code agent creation with AST-parsed configuration
- Built-in Coordination - Manager and Summarizer agents provide automatic oversight
- MANAGED_MESH Architecture - Direct agent communication with conditional routing
- Redis-Powered Persistence - Automatic session management and conversation history
- Enterprise Tool Ecosystem - 15+ built-in tools with OpenAI-compatible function calling
- Advanced Parallel Processing - Multi-session threading with intelligent coordination
Production Features
- Self-Healing Networks - 6 autonomous healing actions with failure detection
- Evolutionary Optimization - Genetic algorithms with real fitness testing
- Adaptive Model Intelligence - ML-powered model selection with performance prediction
Quick Start
1. Installation
pip install leafmesh
2. Environment Setup
# Required: OpenAI API key
export OPENAI_API_KEY="your-openai-key"
# Optional: Additional providers
export ANTHROPIC_API_KEY="your-anthropic-key"
export GOOGLE_API_KEY="your-google-key"
3. Redis Setup
Local Redis:
# macOS
brew install redis && brew services start redis
# Ubuntu/Debian
sudo apt install redis-server && sudo systemctl start redis
# Docker
docker run -d -p 6379:6379 redis:alpine
4. Basic Usage
from leafmesh import LeafMesh
# Initialize from YAML configuration
sdk = LeafMesh.from_yaml("config.yaml")
# Start the mesh
await sdk.start()
# Process requests
response = await sdk.process_request(
session_id="user_session",
input_data={"message": "Hello, how can you help me?"}
)
print(response)
Example YAML Configuration:
name: "my_mesh"
architecture: "managed_mesh"
# Built-in coordination
manager:
enabled: true
model: "gpt-4o"
summarizer:
enabled: true
model: "gpt-4o-mini"
# User-defined agents
agents:
conversation_agent:
name: "conversation_agent"
model: "gpt-4o-mini"
prompt: "You are a helpful AI assistant."
yields:
response: "string"
confidence: "number"
tools: ["calculator", "current_time"]
Architecture Overview
LeafMesh implements a MANAGED_MESH architecture with:
- LLM Agents - YAML-defined with optional Python enhancement
- Manager Agent - Built-in coordination and rule enforcement
- Summarizer Agent - Omnipresent monitoring and analysis
- Redis Persistence - Automatic session and conversation storage
- Event System - All communication flows through events
- Tool System - OpenAI-compatible function calling
For detailed architecture information, see docs/ARCHITECTURE.md
Agent Enhancement
Add Python logic to YAML-defined agents:
@sdk.intelligence("conversation_agent")
async def enhance_conversation(llm_response, input_data, context):
"""Add business logic to agent responses"""
# Access conversation history
history = context.get("conversation_history", [])
# Enhance the LLM response
enhanced_response = add_context(llm_response, history)
# Trigger other agents conditionally
if needs_specialist(enhanced_response):
await sdk.trigger_agents(data={"analysis": enhanced_response})
return {
"response": enhanced_response,
"confidence": calculate_confidence(enhanced_response)
}
Revolutionary Features
Self-Healing Networks
# Enable automatic failure recovery
await sdk.enable_self_healing()
# Monitor agent health
health = await sdk.get_agent_health_status()
stats = await sdk.get_healing_statistics()
Evolutionary Optimization
# Optimize mesh configuration automatically
test_scenarios = [
{"input": "Test case 1", "agents": ["conversation_agent"]},
{"input": "Test case 2", "agents": ["technical_agent"]}
]
best_genome = await sdk.evolve_swarm_architecture(test_scenarios)
await sdk.apply_evolved_configuration()
Adaptive Model Selection
# Automatic model selection based on request characteristics
response = await sdk.adaptive_execute(
prompt="Analyze this complex scenario",
preferred_models=["gpt-4o", "claude-3.5-sonnet"]
)
Documentation
- Architecture Guide - Technical implementation details
- Debugging Guide - Troubleshooting and monitoring
- Getting Started - Run
create-leafmesh my-projectto scaffold a complete example project
Use Cases
LeafMesh excels at:
- Customer Service Systems - Multi-tier workflows with self-healing
- Data Analysis Pipelines - Collaborative analytical workflows
- Content Creation - Coordinated writing and editing
- Decision Support - Complex decision-making with oversight
- Workflow Automation - Business process automation
Framework Comparison
| Feature | LeafMesh | LangGraph | CrewAI | AutoGen |
|---|---|---|---|---|
| YAML Configuration | Primary | Code-based | Code-based | Code-based |
| Built-in Coordination | Manager/Summarizer | Manual | Manual | Manual |
| Auto-Persistence | Redis | Manual | Manual | Manual |
| Self-Healing | Production | None | None | None |
| Evolutionary Optimization | Genetic Algorithm | None | None | None |
Licensing
LeafMesh is commercial software owned by LeafCraft.
- Evaluation: 30-day free evaluation for research/development
- Commercial: Requires valid commercial license for revenue-generating use
- Enterprise: Custom enterprise licensing available
Licensing: info@leafcraftstudios.com
Getting Started
- Install LeafMesh and set up Redis
- Create your first YAML configuration with basic agents
- Add Python enhancements for custom logic
- Enable revolutionary features for production
LeafMesh: Production-ready multi-agent AI with YAML-driven simplicity
Copyright 2025 LeafCraft. All rights reserved.
1 maintainer
Metadata
1 maintainer
Release files for leafmesh 2.4.380
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| leafmesh-2.4.380-cp314-none-any.whl | CPython 3.14 | none | any | Details |
| leafmesh-2.4.380-cp313-none-any.whl | CPython 3.13 | none | any | Details |
| leafmesh-2.4.380-cp312-none-any.whl | CPython 3.12 | none | any | Details |
| leafmesh-2.4.380-cp311-none-any.whl | CPython 3.11 | none | any | Details |
| leafmesh-2.4.380-cp310-none-any.whl | CPython 3.10 | none | any | Details |
Total release size: 17.7 MB
Release files / leafmesh-2.4.380-cp314-none-any.whl
| Download URL | leafmesh-2.4.380-cp314-none-any.whl |
|---|---|
| Size | 4.0 MB |
| Tags | CPython 3.14 |
|
SHA-256 checksum How to use checksums |
639550641579fb6bb13795dae1be69dce245cbdbafbc4520cb11a56779e68278
|
|
BLAKE2b-256 checksum How to use checksums |
815a1377562941aab70d61b48fe875834dd30259974d4f72c44aeb462fb7d446
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.2
|
Release files / leafmesh-2.4.380-cp313-none-any.whl
| Download URL | leafmesh-2.4.380-cp313-none-any.whl |
|---|---|
| Size | 3.8 MB |
| Tags | CPython 3.13 |
|
SHA-256 checksum How to use checksums |
b200b94268f99154d9483ace30966bd55715e17dcee3d75e40936bd03475d2c5
|
|
BLAKE2b-256 checksum How to use checksums |
84dd57ef3072093795c199e4e6e459eee7f99f41a30a4e3c031779768e728757
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.2
|
Release files / leafmesh-2.4.380-cp312-none-any.whl
| Download URL | leafmesh-2.4.380-cp312-none-any.whl |
|---|---|
| Size | 3.8 MB |
| Tags | CPython 3.12 |
|
SHA-256 checksum How to use checksums |
82e11060bf5232d2723b75869c38201452159fb0b093ebe700d657fdc580f10d
|
|
BLAKE2b-256 checksum How to use checksums |
fbbf9c68422d256d490e76bb9e90f64b7bb16ddb9b3e48c7ec1797101218a7e7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.2
|
Release files / leafmesh-2.4.380-cp311-none-any.whl
| Download URL | leafmesh-2.4.380-cp311-none-any.whl |
|---|---|
| Size | 3.9 MB |
| Tags | CPython 3.11 |
|
SHA-256 checksum How to use checksums |
95fb50c26274a8c50c87bae1b6a547b9def80eb42e1b079404da930af1cd63b7
|
|
BLAKE2b-256 checksum How to use checksums |
24b4c3da913cb63d63618941f1201200b68fdae269b17e587bfbede3e0e855e0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.2
|
Release files / leafmesh-2.4.380-cp310-none-any.whl
| Download URL | leafmesh-2.4.380-cp310-none-any.whl |
|---|---|
| Size | 2.2 MB |
| Tags | CPython 3.10 |
|
SHA-256 checksum How to use checksums |
02328e81291f110652ebc9e798f74c6b8d59bd55058210779cd2d2fb2bee57b5
|
|
BLAKE2b-256 checksum How to use checksums |
4439eaef28ebe40926c8a65fbc58688386f279f72e0215051bf295140264bd78
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.2
|
