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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

leafmesh-2.4.48-cp314-none-any.whl (2.6 MB view details)

Uploaded Jul 11, 2026 CPython 3.14

leafmesh-2.4.48-cp313-none-any.whl (2.5 MB view details)

Uploaded Jul 11, 2026 CPython 3.13

leafmesh-2.4.48-cp312-none-any.whl (2.5 MB view details)

Uploaded Jul 11, 2026 CPython 3.12

leafmesh-2.4.48-cp311-none-any.whl (2.6 MB view details)

Uploaded Jul 11, 2026 CPython 3.11

leafmesh-2.4.48-cp310-none-any.whl (1.4 MB view details)

Uploaded Jul 11, 2026 CPython 3.10

File details

Details for the file leafmesh-2.4.48-cp314-none-any.whl.

File metadata

Download URL: leafmesh-2.4.48-cp314-none-any.whl
Upload date: Jul 11, 2026
Size: 2.6 MB
Tags: CPython 3.14
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for leafmesh-2.4.48-cp314-none-any.whl
Algorithm	Hash digest
SHA256	`9c718bae7952d5d93cd00c89627c92f3e77be3740d7d9279f6383b40d040eefb`
MD5	`f063a92df96e4ddd851b4a6c9ab9f40f`
BLAKE2b-256	`09a82c41234183ae251fbee072ac27eaf638471f3a8bc8157cfc2e0bcf22ef3d`

See more details on using hashes here.

File details

Details for the file leafmesh-2.4.48-cp313-none-any.whl.

File metadata

Download URL: leafmesh-2.4.48-cp313-none-any.whl
Upload date: Jul 11, 2026
Size: 2.5 MB
Tags: CPython 3.13
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for leafmesh-2.4.48-cp313-none-any.whl
Algorithm	Hash digest
SHA256	`ca066b81f23841ba21cd87eb07c5579cfa759d26cb59ff5a1956dfc372da52ee`
MD5	`fe757edb858e051ebd7c9451823e2a65`
BLAKE2b-256	`12215b348553b2ab4175a8ae794d68b21e0579cf15b8f2e4638f168b95a9c38e`

See more details on using hashes here.

File details

Details for the file leafmesh-2.4.48-cp312-none-any.whl.

File metadata

Download URL: leafmesh-2.4.48-cp312-none-any.whl
Upload date: Jul 11, 2026
Size: 2.5 MB
Tags: CPython 3.12
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for leafmesh-2.4.48-cp312-none-any.whl
Algorithm	Hash digest
SHA256	`45018a8af0f26bf40c4e3d10d20de355f4646eb9145e9b798ccc3023f6dbb435`
MD5	`c2216a4e4146caad67fc722d06dcd430`
BLAKE2b-256	`beba73b3c22cf9ea7a61e5fea3243128416bd04f53a14967e9bbc40ce502d454`

See more details on using hashes here.

File details

Details for the file leafmesh-2.4.48-cp311-none-any.whl.

File metadata

Download URL: leafmesh-2.4.48-cp311-none-any.whl
Upload date: Jul 11, 2026
Size: 2.6 MB
Tags: CPython 3.11
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for leafmesh-2.4.48-cp311-none-any.whl
Algorithm	Hash digest
SHA256	`54e1ec899960e3b845a8a66fc4b9623aa0a32534c68fbba7f45662ac58f83817`
MD5	`a282df881840a774fc2e0deb57d0ac6d`
BLAKE2b-256	`1e43ac95ccd5eec591d244b8dd3ced3a8d1212662e43549662d2e8e9951c0bc3`

See more details on using hashes here.

File details

Details for the file leafmesh-2.4.48-cp310-none-any.whl.

File metadata

Download URL: leafmesh-2.4.48-cp310-none-any.whl
Upload date: Jul 11, 2026
Size: 1.4 MB
Tags: CPython 3.10
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for leafmesh-2.4.48-cp310-none-any.whl
Algorithm	Hash digest
SHA256	`49adc60b63a2d04e132c3fcd0598baad7804412e333f90af18be41f9ce349cbd`
MD5	`c5aa2833600136c2746639001c9f9e24`
BLAKE2b-256	`8b105e5a94679c8382d7aa9dbed6a360415526ac218e2148b19435cb66c334e3`