Beeline

Beeline Instrumentation for your AI agents

Overview

Beeline provides advanced runtime control for your AI agents, enabling you to observe, intervene, and dynamically adjust agent behavior as it executes. By giving you real-time visibility and control, Beeline helps you build more reliable AI systems—catching and correcting issues during execution rather than reacting after failures occur.

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

Quick Links

• Documentation - Complete guides and API reference
• Self-Hosting Guide - Deploy Beeline 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/beeline.git
cd beeline

# 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

• Observe - Real-time visibility into agent execution, decisions, and performance
• Metrics & Analytics - Track costs, latency, and token usage with TimescaleDB
• Cost Control - Set budgets and policies to manage LLM spending
• Real-time Events - WebSocket streaming for live agent monitoring
• Self-Hostable - Deploy on your own infrastructure with full control
• Production-Ready - Built for scale and reliability

Project Structure

beeline/
├── 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

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