Build Your First Agent

First Success Path: This guide walks you through the first step of Aden Hive’s developer success journey: create → debug → maintain → deploy → iterate. By the end, you’ll have a working agent ready to test and refine.

​

Prerequisites

• Python 3.11+ installed
• Claude Code, Cursor, or OpenAI Codex CLI
• At least one LLM API key configured

​

1. Install Hive

git clone https://github.com/adenhq/hive.git
cd hive
./quickstart.sh

• framework runtime package
• aden_tools MCP tools package
• Workspace dependencies for local development

​

2. Create an Agent

claude> /hive

1. Define the goal and success criteria
2. Pick nodes and execution strategy
3. Add constraints and human checkpoints
4. Export the generated agent package under exports/

​

3. Validate and Test

claude> /hive-test

PYTHONPATH=exports uv run python -m faq_agent validate
PYTHONPATH=exports uv run python -m faq_agent info

​

4. Run the Agent

PYTHONPATH=exports uv run python -m faq_agent run --input '{
  "question": "How do I reset my password?"
}'

​

Project Structure

hive/
├── core/                 # Framework runtime
├── tools/                # MCP tools package
├── exports/              # Generated and custom agents
│   └── your_agent/
│       ├── __init__.py
│       ├── agent.json
│       ├── tools.py
│       └── tests/
└── quickstart.sh

​

Next Steps