Skip to main content

Local-first architecture

Avibe runs on your machine. Your codebase, working directory, agent CLI, agent process, logs, and local configuration stay local. Local-first is an architectural stance, not a setting — see Design Philosophy.

Data flow

Avibe is the local runtime that lets your AI colleague live in chat while the actual agent work stays on your machine. It does not add a hidden LLM loop between you and your chosen agent.

Why this matters

  • No hosted coding VM is required.
  • No public inbound port is required for normal chat control.
  • The agent sees the same local project state you would see in a terminal.
  • Token overhead stays near zero because Avibe does not act as a second reasoning agent in front of your chosen agent.

What leaves your machine

Your code at rest, working directory, Agent process, logs, local configuration, and local Agent credentials stay on your machine. Local-first does not mean offline-only. This table is the authoritative boundary inventory. It covers every network path that carries user content or metadata derived from that content, in every available mode. A new path must be added here before it ships. In this inventory, Memory provider data means Memory inputs and all content derived from them. Its current forms are messages, search queries, distilled Memory snippets or candidates used for reranking, and eligible attachment copies. The distilled Memory store and search index remain local. Messages and eligible attachment copies also remain in the local queue while waiting to process. Each external platform or provider handles the traffic it receives under its own policies.

What avibe.bot is for

avibe.bot provides the hosted control plane for secure remote Web UI access and the separate Model Service for Voice input and Memory. When you run:
Avibe helps pair your local Web UI with an authenticated remote URL. Browser traffic goes through the tunnel to your local machine rather than through the avibe.bot application. Your codebase and agent runtime remain local. Access is fail-closed — auth, routing, and host checks default to deny — so a misconfiguration locks you out rather than exposing your machine.