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-project to 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

postgres crewai langgraph autogen a2a mcp composio zapier claude-agent openai-agents scheduler slack telegram teams discord kafka sqs mqtt imap listeners email email-cleaning channels knowledge-mongo knowledge-postgres knowledge-pinecone knowledge-docs knowledge connectors all dev

Metadata

Release files for leafmesh 2.4.270

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for leafmesh 2.4.270
File	Interpreter	ABI	Platform	Reset
leafmesh-2.4.270-cp314-none-any.whl 3.6 MB Sep 17, 2026	CPython 3.14	none	any	Details
leafmesh-2.4.270-cp313-none-any.whl 3.4 MB Sep 17, 2026	CPython 3.13	none	any	Details
leafmesh-2.4.270-cp312-none-any.whl 3.4 MB Sep 17, 2026	CPython 3.12	none	any	Details
leafmesh-2.4.270-cp311-none-any.whl 3.5 MB Sep 17, 2026	CPython 3.11	none	any	Details
leafmesh-2.4.270-cp310-none-any.whl 2.0 MB Sep 17, 2026	CPython 3.10	none	any	Details

Total release size: 16.0 MB

Release files / leafmesh-2.4.270-cp314-none-any.whl

Download URL	leafmesh-2.4.270-cp314-none-any.whl
Size	3.6 MB
Tags	CPython 3.14
SHA-256 checksum How to use checksums	`679b0a7bc1821d6f17db8b86bc3ffc67650c5924a78fdf5811f4f1554f8b1a06`
BLAKE2b-256 checksum How to use checksums	`70168fad97d05971b4bbfbc1efbb344d45d4ff9e37d8fb047a2a5f1038e3c36f`
Upload date	Sep 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.13`

Release files / leafmesh-2.4.270-cp313-none-any.whl

Download URL	leafmesh-2.4.270-cp313-none-any.whl
Size	3.4 MB
Tags	CPython 3.13
SHA-256 checksum How to use checksums	`f3d5cd566fc22ec371fe560ac1360c3397e78fd0fd12c15edbc24e44535883ee`
BLAKE2b-256 checksum How to use checksums	`daaa10654573b7dc83ee17945a1806c77470bbfb5f4806966bd10f97944434b0`
Upload date	Sep 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.13`

Release files / leafmesh-2.4.270-cp312-none-any.whl

Download URL	leafmesh-2.4.270-cp312-none-any.whl
Size	3.4 MB
Tags	CPython 3.12
SHA-256 checksum How to use checksums	`ea72a1d81d6344d53cb87ffeb6e957a3bcc78e4c122cb40be021580cf87202ea`
BLAKE2b-256 checksum How to use checksums	`81e2c2cf1a9e0c1a9d08588ba1b17fa7572da90790795f24d8649ebd7016f8e2`
Upload date	Sep 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.13`

Release files / leafmesh-2.4.270-cp311-none-any.whl

Download URL	leafmesh-2.4.270-cp311-none-any.whl
Size	3.5 MB
Tags	CPython 3.11
SHA-256 checksum How to use checksums	`159fde641690fad4e3c4187c2d88d6aeac7d2eb7b17fb6566ceb8baa2920ca2e`
BLAKE2b-256 checksum How to use checksums	`fe3739effec739a31e565a794b637f2a3d0091919714a3391dc09262fca66522`
Upload date	Sep 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.13`

Release files / leafmesh-2.4.270-cp310-none-any.whl

Download URL	leafmesh-2.4.270-cp310-none-any.whl
Size	2.0 MB
Tags	CPython 3.10
SHA-256 checksum How to use checksums	`55a229c83b23b6c90f9d04118a1e13f2e1d659e646cea5168bcf05f5b68f260a`
BLAKE2b-256 checksum How to use checksums	`4151631363e26cc9e2cb07cc637214b93e20f9b691b7825175ec2b773e7d3e7a`
Upload date	Sep 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.13`