I want HQ without managing infrastructure
Sign up at app.yourhq.ai. We handle the database, runtime, and updates. Bring your own model API key and create agents in under 2 minutes.
I want to self-host it
Install on your own machine. Full control, completely free. The onboarding wizard walks you through everything in about 15 minutes.
I want to understand the product
Learn what HQ includes: agents, CRM, tasks, knowledge, routines, collections, gateways, usage, and budgets.
I want to build agents
Understand templates, memory, knowledge items, channel setup, delegation, and agent worktrees.
I want to customize or fork it
Set up local development and learn how the UI, gateway, migrations, and templates fit together.
I want to review security
Review the trust model, service role key, Docker socket, noVNC, public exposure, and hardening.
Common first tasks
Install locally
Run HQ on your own machine.
Add a gateway
Attach another host to run agents.
Connect a model
Any provider — OpenAI, Anthropic, Gemini, Ollama, and more.
Create an agent
Provision an agent from a template.
Add knowledge
Give agents shared context.
Set budgets
Track usage and enforce monthly limits.