Skip to Content
DocumentationIntroduction

Introduction

Companion Intelligence is a self-hosted AI platform: software you download or hardware you own, running entirely on your machine. It is your private AI infrastructure, your personal cloud, and your Companion Memory in one stack.

The Companion stack, layer by layer Five layers of the platform drawn as isometric slabs stacked one above the next, each slab a true isometric rhombus with a visible edge, lit from high on the left so that the top face of every slab is the palest of its three and the left face the darkest. Lowest is Companion Core, the Framework Mini-ITX board in its steel chassis; above it Companion OS; then Companion Hub, held a full step deeper in the campaign’s phthalo green because it is the layer this plate is about; then Companion Memory and Agents; and on top an open plane carrying a four-by-three grid of twelve rounded tiles, one for each catalogue app: Companion Memory, OpenClaw, Hermes, Planning, Capture, Spellbook, Local Bench, Just In Case, Earth, Photo Time Machine, Web XR Scan and Glasses Bridge. Each tile carries a simple line mark drawn for this sheet — a node graph, a pincer, a paper dart, three checked rows, an arrow dropping into a tray, an open book, a gauge and needle, two rings on four spokes, a globe, a framed landscape, four scan brackets, and a pair of lenses under a signal arc — rather than the shipped icon artwork, which is raster and cannot be read at this size. A dashed lead runs from the right corner of every slab out to its name and a single line of description in a column down the right-hand side. Your apps, your agents, your filesWhatever you install, and whatever you write. Companion Memory and AgentsA knowledge graph. Agents on your hardware. Companion HubYour private server. Sandboxed installs. Companion OSLinux, tuned to run local models unattended. Companion CoreA Framework Mini-ITX board in a steel chassis.
The Companion stack. From the bottom: Companion Core hardware, Companion OS, Companion Hub, Companion Memory and agents, and on top whatever you install and whatever you write.

Every cloud service you rent — Dropbox, Slack, Spotify, Google Drive, ChatGPT — is a subscription paid with money and data. Companion Intelligence lets you run open-source equivalents, local AI models, and personal agents under one roof and keep the results on your own storage.

Companion Hub is the software that installs and manages self-hosted apps through a web dashboard, desktop app, and CLI. It is free for personal and nonprofit use, and runs on Linux, Windows, and macOS as well as on Companion Core hardware built for local inference.

This documentation covers the full ecosystem:

AreaWhat it covers
Companion Hub dashboardCompanion Hub dashboardCompanion HubSystem overview, local app runtime, and dashboard
CI Account Home with one paired Hub and its appsCI Account Home with one paired Hub and its appsCI AccountRemote access, device pairing, and public access flows at hub.ci.computer 
Companion Hub App Store, Featured viewCompanion Hub App Store, Featured viewFirst-party appsCompanion Intelligence apps that work on Hub and with Companion Memory
Companion Atlas desktop overview with the globe, a selected memory, and the time machineCompanion appsUser-facing clients, wearables, and interfaces across devices
Companion Memory knowledge graphCompanion Memory knowledge graphConnecting your own agentPoint an MCP client you already run at your Hub and Memory

If you already run OpenClaw, Hermes, Claude Code, or another MCP-capable client, it can connect to your Hub and Companion Memory directly: appliance management from Hub, recall and capture from Memory. See Connect an existing agent.

Capture to memory. Sources feed one inlet on a single box; inside it a database fills, a knowledge graph grows from it, and an agent reads the graph. That recall is what an MCP client gets when you connect it to Companion Memory.

To run Companion Hub now, follow Your first hour from installation to a working app. If you have a Companion Core, start with the Core Server quick start. Continue below for a product overview.

Why Companion Hub?

  • Ownership by default: run your apps, data, and AI on hardware you control.
  • Privacy by design: local-first architecture with no analytics, usage tracking, or training on your data. Anonymous crash reports are on by default, and you can turn them off in Settings.
  • One dashboard: install apps, manage updates, inspect logs, and configure networking from one interface.
  • Integrated AI: local inference through Ollama, oMLX, vLLM, or Lemonade, optional cloud providers, and standardized inference settings passed directly to apps.
  • Managed remote access: Tailscale and Cloudflare Gateway without manual port forwarding.
  • A broader ecosystem: Hub is the foundation for your CI Account, Companion Memory, agents, and hundreds of installable apps.

How the platform fits together

Companion Hub and Companion Memory run on your machine. Capture tools send events and media into Memory, agents connect to Memory and Hub over MCP, and your CI Account handles device pairing, remote access, and Organizations:

In practical terms:

  • Companion Hub runs apps and local services on your machine.
  • CI Account (hub.ci.computer ) handles device pairing, remote access, and Organizations.
  • Companion App Store publishes the catalog of installable apps.
  • First-party, third-party, and companion apps provide the user-facing tools built on top of that stack.

Companion Hub runs on Docker, and each app is an isolated Docker Compose stack. Beyond standard containers (runc), Hub supports microVM isolation via Kata Containers , hardware-encrypted enclaves via Confidential Containers , and virtual appliances via QEMU/KVM. Local apps open on a direct host port, Tailscale Serve publishes Private VPN apps to your tailnet over HTTPS, and a Traefik reverse proxy routes Public Web apps by hostname through the Cloudflare tunnel. For an in-depth tour of the runtime and architecture, see Companion Hub system overview.

You can run Hub via the desktop app (macOS, Windows, Linux), companion-hub --detached on Linux servers without a display, or the bundled cihub CLI for scripting and lifecycle control.

Companion Hub dashboard: Home, App Store, and Resources in the top bar, disk space, CPU load, and memory used cards, and a grid of installed app tiles for Companion Memory, OpenClaw, Immich, Jellyfin, and NextcloudCompanion Hub dashboard: Home, App Store, and Resources in the top bar, disk space, CPU load, and memory used cards, and a grid of installed app tiles for Companion Memory, OpenClaw, Immich, Jellyfin, and Nextcloud
The Companion Hub dashboard: install apps, manage updates, check logs, and configure networking from one place. The apps shown are example data.

Try it live

Some Companion sites run in your browser, so you can open one now and read its docs page when you want the detail.

  • Companion Spatialxr.ci.computerA phone-first augmented-reality app that overlays nearby places, history, and weather on your camera view.Open site Read the docs
  • Photo Time Machinephoto.ci.computerA viewer that turns an image, image set, or video into a shareable 3D model. You point it at a server you run.Open site Read the docs
  • Virtual Homeshomes.ci.computerThirty homes, each built live in your browser from one spec file. Fly the camera paths and change the hour.Open site Read the docs
  • Spellbookmagic.ci.computerA searchable catalog of local-AI and self-hosting tools, organized by the job you are doing.Open site Read the docs
  • Avatar Companionavatar.ci.computerA 3D companion you talk to, in a browser or a headset. The hosted demo has no backend, so it runs the scripted demo.Open site Read the docs

Setting up a device? The full Companion sites list also has the setup guides for Home Assistant Voice PE, Even Realities, Mentra Live, and Pebble.

Get a Companion Core, a personal AI appliance and local server, or download Companion Hub to turn a computer you already own into one.Buy Companion Core →Download Companion →Back to ci.computer

Start here, then branch out

Your first hour walks the whole path on one page: Docker → Ollama → Hub → your first app. To follow separate pages instead:

  1. Install Hub on your machine
  2. Pair with your CI Account: a fresh Hub opens on the device registration screen, and pairing enables remote access and Organizations
  3. Sign in as the first admin
  4. The onboarding wizard launches to set up AI, apps, and remote access
  5. Install your first app from the Companion App Store
Last updated on