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_agent routing
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_KEY in .env)

License

MIT

Metadata

Release files for create-leafmesh 2.7.1

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

Source distribution (sdist)

Source distribution for create-leafmesh 2.7.1
File	Size	Uploaded	Provenance
create_leafmesh-2.7.1.tar.gz	1.4 MB	Sep 16, 2026	Without provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for create-leafmesh 2.7.1
File	Interpreter	ABI	Platform	Reset
create_leafmesh-2.7.1-py3-none-any.whl 1.7 MB Sep 16, 2026 Without provenance	Python 3	none	any	Details

Total release size: 3.1 MB

Release files / create_leafmesh-2.7.1.tar.gz

Download URL	create_leafmesh-2.7.1.tar.gz
Size	1.4 MB
Tags	Source
SHA-256 checksum How to use checksums	`119cb2f64bcd85cedf0eb1443decf923802bde38269d615e02de15d8011671d5`
BLAKE2b-256 checksum How to use checksums	`e333e7bc2fe1529ddf008a3819258d0402ab2efe2219da2b836c13135ccba440`
Upload date	Sep 16, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.13`

Release files / create_leafmesh-2.7.1-py3-none-any.whl

Download URL	create_leafmesh-2.7.1-py3-none-any.whl
Size	1.7 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`28ff8d60ee3ddba9da3cdee357ff43cdbfcc4b52dfd0436c65612def12b8a276`
BLAKE2b-256 checksum How to use checksums	`800efbed98c2c70bb42845f0fed00c86291a28ea2afb9d60ea5dbe1c40508d1f`
Upload date	Sep 16, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.13`

Security for create-leafmesh 2.7.1

Report project as malware

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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A 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.