This directory contains two types of examples to help you build agents with the Hive framework.
recipes/ — "How to make it"
A recipe is a prompt-only description of an agent. It tells you the goal, the nodes, the prompts, the edge routing logic, and what tools to wire in — but it's not runnable code. You read the recipe, then build the agent yourself.
Use recipes when you want to:
- Understand a pattern before committing to an implementation
- Adapt an idea to your own codebase or tooling
- Learn how to think about agent design (goals, nodes, edges, prompts)
templates/ — "Ready to eat"
A template is a working agent scaffold that follows the standard Hive export structure. Copy the folder, rename it, swap in your own prompts and tools, and run it.
Use templates when you want to:
- Get a new agent running quickly
- Start from a known-good structure instead of from scratch
- See how all the pieces (goal, nodes, edges, config, CLI) fit together in real code
# 1. Copy the template
cp -r examples/templates/marketing_agent exports/my_agent
# 2. Edit the goal, nodes, and edges in agent.py and nodes/__init__.py
# 3. Run it
uv run python -m exports.my_agent --help- Read the recipe markdown file
- Use the patterns described to build your own agent — either manually or with the builder agent (
/hive) - Refer to the core README for framework API details