The-Vibe-Company/companion

Persistent AI companions on Box, powered by Pi. Simple web, durable execution, reproducible local development.

What it solves

This project provides a platform for creating persistent AI companions that possess their own isolated Linux computing environments. It solves the problem of AI agents lacking a durable, private workspace where they can execute code, manage files, and perform automated tasks independently of the user's local machine.

How it works

The system uses an agent harness called "Pi" and a Bun-packaged Linux runtime to give each companion an isolated environment. It utilizes a PostgreSQL database for the control plane and a React-based web client for user interaction. The architecture supports multiple model providers (including Google, Anthropic, and OpenAI) and can be deployed locally via Docker or hosted using Box for remote desktop and headless execution. It includes a "companion-control" MCP (Model Context Protocol) to manage identity, routines, and plugins.

Who it’s for

It is designed for users and developers who want autonomous AI agents capable of performing background routines, managing private files, and interacting with external services via OAuth and MCP connections.

Highlights

  • Isolated Compute: Each companion has its own Linux runtime and isolated set of files and connections.
  • Cancellable Tasks: Supports tool calls with cancellation and recovery mechanisms to prevent repeating effects after a crash.
  • Automated Routines: Features background routines, signed webhooks, and scheduled tasks with durable memory.
  • Flexible Deployment: Can be run locally in Docker or hosted on Box for full desktop control and headless work.
  • Model Agnostic: Compatible with various LLM providers including Gemini, GPT, and Claude.

Related

  • Project
  • Project
  • Project
  • Project
  • Project