Skip to main content
Self-hosting guidance is in active iteration. Use this page as an alpha baseline and validate against the latest hive/README.md before production rollout.

​
Overview

Self-hosting Hive gives you control over runtime environment, networking, and credentials.

​
Baseline Setup

  1. Clone and prepare the repository:
git clone https://github.com/adenhq/hive.git
cd hive
./quickstart.sh
  1. Configure provider credentials (for example):
export ANTHROPIC_API_KEY="sk-ant-..."
  1. Run agents from your own infrastructure:
PYTHONPATH=exports uv run python -m your_agent_name run --input '{...}'

​
Deployment Notes

  • Prefer isolated environments (container, VM, or dedicated host)
  • Keep credential material in secure secret stores
  • Use environment-scoped configs for staging vs production
  • Add observability and alerting before enabling autonomous workflows
Complete Deployment Story: Self-hosting covers the infrastructure setup. For comprehensive guidance on deployment strategies, monitoring, and safe rollout procedures, see the deployment guide.

​
Troubleshooting

​
Dependency setup issues

uv sync
uv run python -c "import framework, aden_tools; print('ok')"

​
Runtime import issues

Run commands from the hive/ project root and ensure PYTHONPATH=exports is set.

​
Need Help?

Book a Discovery Call

Get help with production deployment and architecture decisions.

​
Next Steps

Quickstart Guide

Set up local development and first execution

Build Your First Agent

Create and test your first goal-driven agent

Deployment Guide

Move your agent from development to production safely

Monitoring and Ops

Track agent health and performance in production