Overview

Build reliable, self-improving AI agents without hardcoding workflows. Define your goal through conversation with a coding agent, and the framework generates a node graph with dynamically created connection code. When things break, the framework captures failure data, evolves the agent through the coding agent, and redeploys. Built-in human-in-the-loop nodes, credential management, and real-time monitoring give you control without sacrificing adaptability.

Visit adenhq.com for complete documentation, examples, and guides.

Quick Links

• Documentation - Complete guides and API reference
• Self-Hosting Guide - Deploy Hive on your infrastructure
• Changelog - Latest updates and releases

• Report Issues - Bug reports and feature requests

Quick Start

Prerequisites

• Docker (v20.10+)
• Docker Compose (v2.0+)

Installation

# Clone the repository
git clone https://github.com/adenhq/hive.git
cd hive

# Copy and configure
cp config.yaml.example config.yaml

# Run setup and start services
npm run setup
docker compose up

Access the application:

• Dashboard: http://localhost:3000
• API: http://localhost:4000
• Health: http://localhost:4000/health

Features

• Goal-Driven Development - Define objectives in natural language; the coding agent generates the agent graph and connection code to achieve them
• Self-Adapting Agents - Framework captures failures, updates objectives and updates the agent graph
• Dynamic Node Connections - No predefined edges; connection code is generated by any capable LLM based on your goals
• SDK-Wrapped Nodes - Every node gets shared memory, local RLM memory, monitoring, tools, and LLM access out of the box
• Human-in-the-Loop - Intervention nodes that pause execution for human input with configurable timeouts and escalation
• Real-time Observability - WebSocket streaming for live monitoring of agent execution, decisions, and node-to-node communication
• Cost & Budget Control - Set spending limits, throttles, and automatic model degradation policies
• Production-Ready - Self-hostable, built for scale and reliability

Project Structure

hive/
├── honeycomb/          # Frontend (React + TypeScript + Vite)
├── hive/               # Backend (Node.js + TypeScript + Express)
├── docs/               # Documentation
├── scripts/            # Build and utility scripts
├── config.yaml.example # Configuration template
└── docker-compose.yml  # Container orchestration

Development

Local Development with Hot Reload

# Copy development overrides
cp docker-compose.override.yml.example docker-compose.override.yml

# Start with hot reload enabled
docker compose up

Running Without Docker

# Install dependencies
npm install

# Generate environment files
npm run generate:env

# Start frontend (in honeycomb/)
cd honeycomb && npm run dev

# Start backend (in hive/)
cd hive && npm run dev

Documentation

• Developer Guide - Comprehensive guide for developers
• Getting Started - Quick setup instructions
• Configuration Guide - All configuration options
• Architecture Overview - System design and structure

Roadmap

Aden Agent Framework aims to help developers build outcome orienated, self-adaptive agents. Please find our roadmap here

ROADMAP.md

Community & Support

We use Discord for support, feature requests, and community discussions.

• Discord - Join our community
• Twitter/X - @adenhq
• LinkedIn - Company Page

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Join Our Team

We're hiring! Join us in engineering, research, and go-to-market roles.

View Open Positions

Security

For security concerns, please see SECURITY.md.

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

---

Made with care by the Aden team