Install
Vitrino is a desktop app. There is nothing to run on a server and no account to create — you install it, give it an Anthropic API key, and point it at a folder on your machine.
Downloads for every platform are on the vitrino.dev download page. The page offers the build for the machine you are on; the full list is below it.
macOS
Requires macOS 11 Big Sur or later. There are two builds: Apple silicon (M‑series) and Intel. If you are not sure which you need, the download page picks for you.
- Open the
.dmg. - Drag Vitrino into Applications.
- Open it from Applications or Launchpad.
Vitrino is signed with an Apple Developer ID and notarised by Apple, so it opens normally. If macOS says the app "is damaged and can't be opened", the download did not complete — delete it and download again rather than trying to override the warning.
Windows
Requires Windows 10 or later, on x64 or ARM64. The installer is a per‑user install: it does not need an administrator password, and it lets you choose the folder.
The installer is not code‑signed yet, so Windows SmartScreen will warn you the first time:
- Run
vitrino-<version>-win-<arch>-setup.exe. - On the blue "Windows protected your PC" screen, choose More info.
- Check the publisher is what you expect, then choose Run anyway.
Note
That warning is about the absence of a signature, not about anything found in the file. It will go away when Windows signing is in place.
Linux
Three formats, for x64 and ARM64:
| Format | Install with |
|---|---|
.deb | sudo apt install ./vitrino-<version>-linux-<arch>.deb |
.rpm | sudo dnf install ./vitrino-<version>-linux-<arch>.rpm |
| AppImage | chmod +x the file, then run it |
The .deb and .rpm packages run a post‑install step that sets up Chromium's sandbox for your system — a setuid helper where user namespaces are disabled, or an AppArmor profile on Ubuntu 24.04 and later. That means you should never need to pass --no-sandbox. If you find yourself wanting to, something is wrong; see Troubleshooting.
Tip
The AppImage has no installer and so cannot do that setup. On a distribution with unprivileged user namespaces disabled, prefer the .deb or .rpm.
What gets installed
Vitrino bundles its own copy of Claude Code. You do not need to install Claude Code separately, and Vitrino does not use one you already have — so upgrading Vitrino is what upgrades the agent.
It does read the configuration Claude Code already uses on your machine: CLAUDE.md files, skills, plugins and MCP servers. See Project configuration.
Next
First run covers signing in and opening your first project.