Skip to main content

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.

HQ hosted is the managed version of HQ at app.yourhq.ai. You get the same platform as the open-source self-hosted version — agents, CRM, tasks, knowledge, routines — without managing Docker, Supabase, or any infrastructure.You sign up, we provision a dedicated workspace (database + agent runtime), and you’re ready to create agents in under two minutes.
$30/month per workspace. This includes:
  • Dedicated database (your own Supabase project)
  • Dedicated agent runtime (sandbox)
  • Unlimited agents, contacts, tasks, and knowledge items
  • All features — no tier restrictions
Model API costs are separate. You bring your own API key (OpenAI, Anthropic, etc.) and pay your provider directly. HQ never charges for model usage.
Everything. The hosted version runs the same codebase as the open-source version. The only difference is who manages the infrastructure:
Self-hostedHosted
You manageDocker, Supabase, networking, updatesNothing
We manageNothingDatabase, agent runtime, updates
FeaturesAllAll
AgentsUnlimitedUnlimited
Data locationYour machineDedicated Supabase project (US East by default)
CostInfrastructure + model API$30/mo + model API
Self-hosted is free (you pay for your own infrastructure). Hosted is $30/mo and we handle infrastructure.
There’s no free trial at the moment. Two options to evaluate:
  • Self-hosted version — free, identical features, runs on any machine with Docker. Get started →
  • Hosted sign-up — $30/month, cancel anytime. You’ll have agents running in under 2 minutes.

​
Data and security

Each workspace gets a dedicated Supabase project — your database is not shared with other customers. By default, Supabase projects are provisioned in US East (us-east-1).Your agent runtime runs in a dedicated sandbox. Agent memory, files, Chrome profiles, and conversation history live in that sandbox.
We have administrative access to the Supabase Management API (needed to provision and manage your project), but we do not access your workspace data in normal operations. Your agent conversations, CRM contacts, knowledge items, and API keys live in your dedicated project.HQ is open source — you can audit exactly what the hosted version runs.
Your model provider API keys (OpenAI, Anthropic, etc.) are stored in your workspace’s dedicated Supabase project. They’re used only to route model calls on your behalf. They’re never stored in or accessible from a shared system.
Data portability is on the roadmap. The goal is to let you export your full workspace and import it into a self-hosted HQ instance (or vice versa) with a single command. The database schema is identical between hosted and self-hosted.In the meantime, your Supabase project uses standard Postgres — all your data is in standard tables with documented schemas.

​
Account management

Yes. Each workspace is independent — separate database, agents, CRM, and billing. Add a workspace from the Account page. Each is billed at $30/month.
Go to Account → click Cancel next to the workspace. Your workspace stays active for 30 days (grace period), then it’s permanently deleted. Canceling one workspace doesn’t affect others.See Account & billing for details.
During the 30-day grace period: everything stays active. After 30 days: the agent runtime is destroyed, the Supabase project is deleted, and all data is permanently removed. This cannot be undone.
Data migration between hosted and self-hosted is on the roadmap. The schema is identical, so the migration is technically straightforward — we’re building a one-click tool for it.Until then, you’d need to manually export/import your Postgres data.
Go to Account → Open Stripe. The Stripe Customer Portal lets you update your card, view invoices, and see your next billing date.

​
Agents and features

All of them — the same as self-hosted. HQ is model-agnostic:
  • API key providers: OpenAI, Anthropic, Gemini, DeepSeek, Mistral, Groq, OpenRouter, and 15+ more
  • OAuth providers: OpenAI Codex, GitHub Copilot
Each agent can use a different model. You pay the provider directly through your own API key.
Local models (Ollama, LM Studio) require a publicly reachable URL since the agent runtime runs in a cloud sandbox, not on your machine.
Yes. Channel setup works exactly the same as self-hosted:
  • Telegram: create a bot at @BotFather, paste the token
  • Discord: create a bot in the Developer Portal, paste the token
  • Slack: OAuth flow through HQ’s settings
Webhooks from messaging platforms route directly to your agent runtime.
There’s no hard limit on the number of agents. In practice, the runtime handles 5–10 active agents comfortably. If you need more, contact us.
No. We handle all infrastructure updates — database migrations, runtime updates, and security patches. Your workspace is always on the latest version.
Yes — from the UI. After creating an agent, you can edit its identity, personality, memory, and skills directly from the agent detail page. The Personality tab lets you edit IDENTITY.md and SOUL.md with a rich-text editor, and changes apply immediately.For deeper customization (creating entirely new templates from scratch), the self-hosted version gives you full filesystem access to the template library.

​
Support

Email [email protected]. Do not open a public GitHub issue for security vulnerabilities.