> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yourhq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Choose your path

> Find the right starting point based on what you want to do with Your HQ.

HQ is useful to different people for different reasons. Start with the path that matches what you are trying to do today.

<CardGroup cols={2}>
  <Card title="I want HQ without managing infrastructure" icon="cloud" href="/hosted/getting-started">
    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.
  </Card>

  <Card title="I want to self-host it" icon="server" href="/getting-started/quickstart">
    Install on your own machine. Full control, completely free. The onboarding wizard walks you through everything in about 15 minutes.
  </Card>

  <Card title="I want to understand the product" icon="map" href="/concepts/features">
    Learn what HQ includes: agents, CRM, tasks, knowledge, routines, collections, gateways, usage, and budgets.
  </Card>

  <Card title="I want to build agents" icon="wand-magic-sparkles" href="/concepts/agents">
    Understand templates, memory, knowledge items, channel setup, delegation, and agent worktrees.
  </Card>

  <Card title="I want to customize or fork it" icon="code" href="/development/local-development">
    Set up local development and learn how the UI, gateway, migrations, and templates fit together.
  </Card>

  <Card title="I want to review security" icon="shield-halved" href="/security/security-policy">
    Review the trust model, service role key, Docker socket, noVNC, public exposure, and hardening.
  </Card>
</CardGroup>

## Common first tasks

<CardGroup cols={3}>
  <Card title="Install locally" href="/self-host/installation" icon="laptop">
    Run HQ on your own machine.
  </Card>

  <Card title="Add a gateway" href="/self-host/add-gateway" icon="network-wired">
    Attach another host to run agents.
  </Card>

  <Card title="Connect a model" href="/guides/connect-model-provider" icon="plug">
    Any provider — OpenAI, Anthropic, Gemini, Ollama, and more.
  </Card>

  <Card title="Create an agent" href="/guides/create-agent" icon="user-plus">
    Provision an agent from a template.
  </Card>

  <Card title="Add knowledge" href="/guides/agent-boot-docs" icon="file-lines">
    Give agents shared context.
  </Card>

  <Card title="Set budgets" href="/guides/usage-budgets" icon="gauge-high">
    Track usage and enforce monthly limits.
  </Card>
</CardGroup>