Onboarding Wizard
When you first log in to Companion Hub, the setup wizard helps you configure your local AI, pick a few self-hosted apps, and connect secure remote access — all on a single scrolling page, with one Finish setup button at the bottom that installs everything and completes setup.
The wizard only appears once — after finishing it you’ll go straight to the dashboard on future logins. Everything you choose here can be changed later in Settings.
At the very top, a System Overview card summarizes the hardware the Hub detected — OS, CPU, RAM, GPU, VRAM, and storage — with a readiness badge and any GPU runtime guidance, so you know at a glance what your machine can run.
Agent Framework
The first step chooses the personal AI agent that powers your system: OpenClaw (the recommended coding & computer-use agent) or Hermes (an advanced reasoning assistant) — you can pick one or more. A Remote access row selects how you’ll reach your Hub from elsewhere: Private VPN via Tailscale, or Web via Cloudflare.
Uncloud your life
Below the agent choice, an Uncloud your life section pre-selects the core memory apps — Companion Memory and Memory Import Tools — that install with sensible defaults and give your agents a memory that knows you.
Recommended Models
The Recommended Models step lists models matched to your detected hardware. Models already present in Ollama are pre-selected and marked Installed (with an agent default tag on the model the agent uses); check any additional models you want to download, or leave them off. A footer tallies how much you’ll download against your free disk, and an Other Models drawer groups the rest by size with intelligence and tool-use scores.
Set up Private VPN
Connect your Hub to Tailscale for secure remote access from anywhere. If the Hub can reach Tailscale you can log in inline; otherwise the step explains it couldn’t find a Tailscale CLI or sidecar and lets you skip and set it up later in Settings → Network. Either way, it links the Tailscale app for Windows, macOS, Linux, and Mobile so you can install it on your other devices.
Learn more in the Tailscale documentation.
Recommended Apps
The Recommended Apps step offers popular open-source apps you can self-host — such as OpenClaw, Immich (photo & video backup), Nextcloud (file sync), and Vaultwarden (password manager). Select any you’d like installed.
Advanced (optional)
An optional Advanced step lets you paste Cloud API keys — OpenAI, Anthropic, Google AI, or GitHub Copilot — if you’d rather use a hosted provider instead of, or alongside, local models.
If your hardware can’t run local models, use this section to configure a hosted provider instead.
Install & Finish
When you’re ready, click Install & Finish. The Hub queues your selected apps and models and shows per-item progress (Installing…, Queued, Pinned). Everything keeps installing in the background — click Continue (apps installing in background) to head to the dashboard.
On mobile
The whole flow is responsive: the steps and app grids reflow to a single column, and the Install & Finish bar stays pinned to the bottom.
Re-running the wizard
The setup wizard is a one-time experience. Afterwards you can install more apps anytime from the App Store, and adjust AI, models, and networking in Settings.
Service detection only finds Docker containers running at the time of the scan. If you start new services later, you can find alternatives manually in the App Store’s Alternatives section.