Hive documentation / Start here

Hive documentation

Install Hive, configure models, build a durable AI staff, run agents and Colony crews, automate work, and operate Hive safely.

Hive is a local-first command center for AI work. You can begin with one agent, develop a reusable Staff directory, coordinate specialists in a Colony, and turn successful work into pipelines, schedules, or webhooks.

New to the product? Follow Your first hour with Hive for an end-to-end tour.

Choose a starting point

I want to… Start here
Install the desktop app or run from source Installation
Connect Ollama or a cloud provider Models and providers
Understand every environment setting Configuration
Build reusable specialists Staff
Create and fully configure an agent Create and configure an agent
Understand every agent parameter Edit and tune an agent
Run a coordinated multi-agent team Run your first Colony
Build a multi-step workflow Build and run a pipeline
Schedule or externally trigger work Schedules or webhooks
Fix a problem Troubleshooting

Capability map

People and execution

  • Staff — durable role profiles with personality, prompts, skills, tools, memory, model preferences, performance, and improvement suggestions.
  • Agents and tools — individual runtime workers for chat and tasks.
  • Colony missions — recipe-driven teams with a shared blackboard, explicit handoffs, and evidence.
  • Pipelines and automation — repeatable multi-step execution, schedules, retries, and run history.

Models, tools, and connections

Operating Hive

Hive stores its state locally under ~/.hive by default. Read Security and architecture before enabling sandbox network access or remote exposure, and keep Backups and recovery close when upgrading.

Hands-on guide library

Agents

Teams and workflows