DOCS · GETTING STARTED

From install to your first agent

This guide takes you from installing Vantisso out of a prebuilt evaluation package to running your first AI agent from the browser console — no Go toolchain or source checkout required. The 30-day evaluation, counted from first run, unlocks every feature.

Last updated · 2026-07-16

1 · Before you start

Vantisso isolates each agent inside a MicroVM on top of hardware virtualization (KVM), so it runs on a Linux host. Before you start, make sure your host meets the requirements below.

Choosing FULL or SLIM

Each release ships two packages. If this is your first time, we recommend FULL — it’s the simplest path.

Install the runtime packages with the commands below. The second line is only needed if you use the SLIM package.

# Runtime packages (both variants)
sudo apt-get install -y iproute2 dmsetup iptables

# SLIM package only — the first boot builds the VM image
sudo apt-get install -y curl util-linux e2fsprogs coreutils

2 · Download the trial

Get the Vantisso trial from the public release repository. Each package includes an evaluation license valid for 30 days from first run, so you can start immediately with no key-issuing step.

To download straight from the terminal and verify integrity, use the commands below. The bundled .sha256 checksum confirms the file arrived intact.

# Download the FULL package and its checksum, then verify
curl -LO https://github.com/ax-onn/vantisso-releases/releases/download/eval01-rc1/vantisso-eval01-linux-amd64-full.tar.gz
curl -LO https://github.com/ax-onn/vantisso-releases/releases/download/eval01-rc1/vantisso-eval01-linux-amd64-full.tar.gz.sha256
sha256sum -c vantisso-eval01-linux-amd64-full.tar.gz.sha256

3 · Install

Unpack the package you downloaded and run the interactive installer.

tar xzf vantisso-eval01-linux-amd64-full.tar.gz
cd vantisso-eval01
sudo ./install.sh

The installer walks you through these steps, interactively:

1. Preflight — verifies amd64, /dev/kvm, and the runtime tools (plus the image-build tools for SLIM); aborts with a clear message if anything is missing.
2. Install — places the binaries and config templates into /opt/vantisso, the daemon’s working directory.
3. LLM setup — prompts for your provider (google / anthropic / openai / groq), model, and API key, writing configs/vantisso.yaml and vantisso-secrets.yaml (mode 0600).
4. API token — offers to generate a control-plane access token (stored in vantisso.env).
5. Service — registers a systemd service (vantisso), enables it, and starts it.

Once install finishes, reach the console and the service here:

4 · Run your first agent

Now spawn an agent and chat with it from the browser console — all clicks, no command line.

1. Open `http://localhost:3000/ui/` in your browser. If you generated an API token during install, enter it and click Sign in; if you didn’t set one, you go straight to the console.
2. A banner at the top — “Evaluation license — N days left” — shows the time left in your evaluation. You land on the VMs tab of the Operator plane.
3. Click Create VM, pick a Profile (the provider and model you chose during install are ready as the default profile), and Create. The new VM appears in the list and moves from spawning → ready (usually under a second).
4. Click that VM to open its detail view, where you’ll find the Conversation panel. Type a message and press Send (Enter) to get the agent’s reply. Try: Say hello and list the tools you can use.
5. When you’re done experimenting, clean up with Delete VM on the detail view. Vantisso is ephemeral by construction, so the VM, its network, and its disk are reclaimed without a trace.

5 · Next steps

• User Guides — in-depth docs on the concepts behind profiles, snapshots, the MCP gateway, and team collaboration.
• API Reference — the REST API for controlling and managing Vantisso from your own application or an enterprise IT operations portal.
• After the evaluation ends — once 30 days pass, reading VMs, running tasks, and tearing down all keep working, but spawning new VMs or agent groups stops (403 trial_expired). The console’s top banner always shows the time remaining.