Skip to content

Latest commit

 

History

History
 
 

README.md

Templates

A template is a working agent scaffold that follows the standard Hive export structure. Copy it, rename it, customize the goal/nodes/edges, and run it.

What's in a template

Each template is a complete agent package:

template_name/
├── __init__.py       # Package exports
├── __main__.py       # CLI entry point
├── agent.py          # Goal, edges, graph spec, agent class
├── agent.json        # Agent definition (used by build-from-template)
├── config.py         # Runtime configuration
├── nodes/
│   └── __init__.py   # Node definitions (NodeSpec instances)
└── README.md         # What this template demonstrates

How to use a template

Option 1: Build from template (recommended)

Use the coder-tools initialize_agent_package tool and select "From a template" to interactively pick a template, customize the goal/nodes/graph, and export a new agent.

Option 2: Manual copy

# 1. Copy to your exports directory
cp -r examples/templates/deep_research_agent exports/my_research_agent

# 2. Update the module references in __main__.py and __init__.py

# 3. Customize goal, nodes, edges, and prompts

# 4. Run it
uv run python -m exports.my_research_agent --input '{"topic": "..."}'

Available templates

Template Description
deep_research_agent Interactive research agent that searches diverse sources, evaluates findings with user checkpoints, and produces a cited HTML report
local_business_extractor Finds local businesses on Google Maps, scrapes contact details, and syncs to Google Sheets
tech_news_reporter Researches the latest technology and AI news from the web and produces a well-organized report