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
Metadata
1 maintainer
Release files for create-leafmesh 2.7.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| create_leafmesh-2.7.5.tar.gz | 1.4 MB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| create_leafmesh-2.7.5-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 3.1 MB
Release files / create_leafmesh-2.7.5.tar.gz
| Download URL | create_leafmesh-2.7.5.tar.gz |
|---|---|
| Size | 1.4 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5df47576e144118ee66ad91d708762ef44b1c4fc5d52404b5cd0bc39e2796ada
|
|
BLAKE2b-256 checksum How to use checksums |
1da094a6d3da2ce8c2b97715b91bedb2b1071fe4e9152f3842f66053e7f7bd4b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.
Transparency logRelease files / create_leafmesh-2.7.5-py3-none-any.whl
| Download URL | create_leafmesh-2.7.5-py3-none-any.whl |
|---|---|
| Size | 1.8 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
738d858f342aba64d79b974898791a9891c5dec40353146a81a3aeb4ad986100
|
|
BLAKE2b-256 checksum How to use checksums |
1162cf7ac111f70f964b17e2ea495f2234a19209b5fc7c83fe2838c45e8c0398
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.
Transparency logSecurity for create-leafmesh 2.7.5
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for create_leafmesh-2.7.5.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
