Vesta

An AI guardian angel that gives you back time and helps you achieve your goals, living in a Docker container, powered by Claude.

Don't want to run a server? vesta.run hosts one for you. Invite-only.

Why Vesta

• Opinionated and easy to set up. One command to install, one command to start. No gateway, no infrastructure to manage.
• Self-improving. Every way Vesta reaches the world (messaging, email, calendars) is a skill Vesta can read and rewrite. Vesta can edit their own source code, write new skills, and fix their own bugs: by default Vesta stays in sync with official updates, but you can let them fully rewrite themselves.
• 1 agent = 1 container. The Docker container is the state. No external databases, no config drift. Back up the container, restore the container.
• Agentic bidirectional sync. Vesta instances can evolve and diverge from the source. Syncing is semantic; the agent understands what changed and why, and merges upstream updates or contributes patches back intelligently.
• Spreads by invitation. Your Vesta can walk your friends through getting their own.
• Secure by default. You write a constitution that Vesta must follow and can never edit, so your rules always hold. A security layer that screens for prompt-injection attacks and can only be overridden by you is on the roadmap.
• Built on Claude's own harness. Benefits from Anthropic RL-maxing their models on it.

Prerequisites

• Claude, Z.AI GLM Coding Plan, Kimi Code, or OpenAI ChatGPT subscription; alternatively, an OpenRouter API key
• Server (vestad): Linux with Docker installed
• Clients: the web app (served by vestad), the desktop app (macOS, Windows, Linux), and mobile — no additional dependencies

Install

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/elyxlz/vesta/master/install.sh | bash

Windows

irm https://raw.githubusercontent.com/elyxlz/vesta/master/install.ps1 | iex

Install specific components

By default, all available components for your platform are installed. Use flags to install only what you need:

# Server only (Linux)
curl -fsSL https://raw.githubusercontent.com/elyxlz/vesta/master/install.sh | bash -s -- --server

# Desktop app only
curl -fsSL https://raw.githubusercontent.com/elyxlz/vesta/master/install.sh | bash -s -- --app

# Specific version
curl -fsSL https://raw.githubusercontent.com/elyxlz/vesta/master/install.sh | bash -s -- --version=0.1.112

Windows installs the desktop app:

# Specific version
irm https://raw.githubusercontent.com/elyxlz/vesta/master/install.ps1 | iex -- --version=0.1.112

Mobile app

• Android: install the latest APK directly (your browser asks once to allow the install). Each release attaches a fresh build.
• iOS: delivered through TestFlight internal testing for now.

Setup

1. Server (Linux)

vestad

On first run, vestad installs a systemd user service, starts itself, and prints the host URL and API key. It runs persistently via systemd (survives logout). A Cloudflare tunnel is set up automatically for remote access.

vestad status    # show service status
vestad logs      # stream service logs
vestad restart   # restart the service
vestad stop      # stop the service

Use vestad serve --standalone to run in the foreground without systemd (for CI/development). Use --no-tunnel to disable the Cloudflare tunnel.

Optional: host layout

Two settings choose where vestad keeps its heavy data. Set them before the first vestad run:

vestad docker-socket set unix:///run/docker-second.sock   # a separate Docker daemon, e.g. one on another disk
vestad backup-dir set /mnt/disk2/vesta-backups            # keep backups on another disk (the directory must exist)

Both are stored in settings.json in the config dir. show prints the value in effect and reset goes back to the default. Later changes restart the service. docker-socket refuses while agents exist, and backup-dir refuses while backups remain at the old location and prints the command that moves them.

2. Client

Copy the connect link from the server output, then reach your agent one of three ways:

• Web app: open the gateway URL from the server output in a browser (vestad serves the app at /app).
• Desktop app: paste the connect link on the onboarding screen (macOS, Windows, Linux).
• Mobile app (iOS and Android): paste the connect link to connect to the same gateway.

Support

Open an issue, or email [email protected].