create-leafmesh
Project scaffolding tool for LeafMesh — the YAML-native multi-agent orchestration platform.
Install
pip install create-leafmesh
Create a Project
create-leafmesh create my-project
cd my-project
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
python main.py
CLI Options
# Create in a specific directory
create-leafmesh create my-project -o /path/to/dir
# Skip git initialization
create-leafmesh create my-project --no-git
# Interactive mode (prompts for project name)
create-leafmesh create
Generated Project Structure
my-project/
configs/
config.yaml # Agent definitions, mesh wiring, HITL config
agency/
greeter_agent.py # LLM agent with @pre_compose
processor_agent.py # Programmatic agent with @conditional_chain
researcher_agent.py # LLM agent with @chain_with_results + smart memory
fallback_researcher_agent.py # Fast fallback (race pattern)
advisor_agent.py # LLM fan-in with @chain + @compose
scheduler_agent.py # Cron-scheduled agent
tools.py # Custom tools (@global_tool, @tool)
external_agents.py # Integration reference (CrewAI, LangGraph, etc.)
main.py # Entry point
hitl_stub_receiver.py # Webhook stub for testing HITL locally
requirements.txt
.env # API keys
Dockerfile
docker-compose.yml # Redis + app
What's Included
- 8 agents showcasing all 4 agent types (human, llm, programmatic, external)
- Human-in-the-Loop (HITL) with dual webhook mode and
from_agentrouting - Fan-in/fan-out with OR expressions (
processor AND (researcher OR fallback)) - Smart memory with hybrid recency/relevance scoring
- Scheduled agents with cron expressions
- Custom tools with access control and categories
- All 5 decorators:
@pre_compose,@chain,@chain_with_results,@conditional_chain,@compose - HITL test stub (
hitl_stub_receiver.py) for local webhook testing - Docker-ready with Redis included
- Full README with HITL walkthrough (2 scenarios, step-by-step)
Requirements
- Python 3.10+
- Redis server running (default: localhost:6379)
- At least one LLM API key (e.g.
OPENAI_API_KEYin.env)
Links
License
MIT
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
create_leafmesh-2.6.6.tar.gz
(1.2 MB
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 create_leafmesh-2.6.6.tar.gz.
File metadata
- Download URL: create_leafmesh-2.6.6.tar.gz
- Upload date:
- Size: 1.2 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.14.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
61b9f0840c25705d446b21f8e1b41e2c585551e3db1c2f53e108d84369d22406
|
|
| MD5 |
4cbd95fa494622d2ca97548e1a1ecd83
|
|
| BLAKE2b-256 |
a3a71b5f9461a848d7cc2241c2f2530e7f8abfd181008007dc1621580de4b52d
|
File details
Details for the file create_leafmesh-2.6.6-py3-none-any.whl.
File metadata
- Download URL: create_leafmesh-2.6.6-py3-none-any.whl
- Upload date:
- Size: 1.6 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.14.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7e6e0113cc99975b88b2a6b624e899c243cb37f494db7feaaa5b8b79f25cebeb
|
|
| MD5 |
43fd8c88d29368a7fd06bdbdc2f39612
|
|
| BLAKE2b-256 |
4861443cf9092aff454646b56ada2a2101f9fdf08e977093627e22948e72c3c6
|
