Self-hosting vs Cloud

Your agent on your infrastructure, or hosted Humaner Cloud.

For AI agents

Self-hosting brief

Open

Copy this Markdown to your Agent to deploy the self-host mailbox (your LLM, your infrastructure). Then paste PUBLIC_AGENT_ID=

Cloud brief

Open

Copy this Markdown to your Agent to deploy Humaner in seconds. Only set your Customer Agent ID into environment variables.

Make your choice

  • Cloud: hosted mailbox, Companion, calendar, and tasks. Custom so your own agent calls the same mailbox over MCP or REST.
  • Self-hosting: your LLM and workspace on your infrastructure. Point teammates and your agent at the same mailbox.
FeatureSelf-hostingCloud
Collaborative mailbox✓✓
Companion (native agent)Your LLMManaged
MCP / REST mailbox tools✓✓
Organization & team access✓✓
Calendar & tasks✓✓
Knowledge retrievalYour stackManaged
Cross-session memory-Cloud
Gmail / Microsoft / IMAPConnect your hosts✓

Self-hosting steps

  1. Fork the repo. Set DATABASE_URL, auth secrets, NEXT_PUBLIC_DEPLOYMENT_MODE=oss, and your LLM API key.
  2. Deploy the dashboard; complete OSS onboarding with a Unique system prompt.
  3. Point your agent at the mailbox over MCP or REST.
  4. Invite teammates to the same workspace.

Next

Quickstart (Cloud)

Connect inbox, invite, policy.

Quickstart (Self-hosting)

Clone, env, pnpm.

Onboard your agent

MCP on the same mailbox.

Companion

Draft, assign, or send.