Skip to main content
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

Before building your first agent, ensure you have:

​
1. Install Hive

git clone https://github.com/adenhq/hive.git
cd hive
./quickstart.sh
This sets up:
  • framework runtime package
  • aden_tools MCP tools package
  • Workspace dependencies for local development

​
2. Create an Agent

Open Claude Code in the repo and run: 
claude> /hive
The guided flow will help you:
  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

Run the testing skill: 
claude> /hive-test
Or run CLI checks manually: 
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

Agents created through Hive are exported to exports/: 
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

Goals

Define measurable outcomes and constraints

Node Types

Learn when to use LLM, router, function, and human nodes

Edges

Configure success, failure, and conditional routing

Testing

Build goal-based test coverage for your agent

Debugging

Diagnose and fix issues before production

Deployment

Move your agent to production safely

Iteration

Evolve your agent based on production feedback