Make your computer a home for your AI partner. Avibe is the local-first Agent OS: Vibey, its built-in AI partner, works out of the box, and Claude Code, Codex & OpenCode run unchanged beside it — reach them from your browser, phone, or any chat app.
Incus tenants for Avibe
This scaffold creates one Avibe tenant per Incus project. It is meant for small hosted bot deployments and operator-run pilots before the full avibe.bot control plane exists.
Use containers for trusted pilots. Use --type vm when the tenant is less
trusted or needs a stronger isolation boundary.
Host setup
Install Incus on the host, then run:
python3 scripts/incus_tenant.py init-host --minimal
--minimal runs incus admin init --minimal. Skip it if the host is already
initialized. The script assumes the default storage pool is default and the
managed bridge is incusbr0; override them per tenant if your host uses
different names.
Check the host without changing it:
python3 scripts/incus_tenant.py doctor
Create a tenant
python3 scripts/incus_tenant.py create alice \
--cpus 2 \
--memory 4GiB \
--disk 30GiB \
--processes 4096 \
--backend codex \
--ui-host-port 15123
This creates:
- Incus project:
vr-alice - Instance:
vibe - Linux user inside the instance:
vibey - Work directory:
/home/vibey/work - Avibe Web UI inside the instance: port
5123 - Optional host Web UI proxy:
http://127.0.0.1:15123
Wait for first boot:
python3 scripts/incus_tenant.py wait-ready alice
Then open the Web UI URL printed by create and complete the normal Vibe
Remote setup wizard for that tenant.
Operate tenants
python3 scripts/incus_tenant.py status alice
python3 scripts/incus_tenant.py shell alice
python3 scripts/incus_tenant.py exec alice -- pwd
python3 scripts/incus_tenant.py stop alice
python3 scripts/incus_tenant.py start alice
python3 scripts/incus_tenant.py restart alice
python3 scripts/incus_tenant.py list
Delete a tenant and all tenant data:
python3 scripts/incus_tenant.py delete alice
Use --dry-run on any command to print the Incus commands without running
them.
The Web UI proxy binds to 127.0.0.1 by default. To expose it on another host
address, pass --ui-host <address> explicitly and protect it with a firewall or
reverse proxy.
Resource model
The scaffold sets limits on both the Incus project and the project default
profile:
limits.cpulimits.memorylimits.processes- root disk
size - one instance per project
Example with a larger tenant:
python3 scripts/incus_tenant.py create buildbot \
--cpus 8 \
--memory 16GiB \
--disk 120GiB \
--processes 16384 \
--ui-host-port 15124
Example with a VM tenant:
python3 scripts/incus_tenant.py create paid-01 \
--type vm \
--cpus 4 \
--memory 8GiB \
--disk 80GiB \
--ui-host-port 15125
Install source
By default, cloud-init installs the latest Avibe via the public installer. To test a branch or fork:
python3 scripts/incus_tenant.py create branch-test \
--install-package-spec 'git+https://github.com/avibe-bot/avibe.git@master' \
--ui-host-port 15126
Security boundary
Tenants get root-like control inside their own Ubuntu environment, not on the
host. Do not give tenants access to the host Incus socket, the incus-admin
group, host Docker socket, host SSH keys, or host secret files.
Container tenants share the host kernel. For arbitrary untrusted paid users,
prefer --type vm, strict resource limits, egress policy, backup/restore
procedures, and operational monitoring before calling the setup production
SaaS-ready.