Skip to content

Install guide

VitruAI runs as an add-in inside Autodesk Revit on Windows. This guide covers download, prerequisites, installation, supported Revit versions, and first launch.

Close Revit before installing

Install VitruAI only when all Autodesk Revit instances are closed. This avoids file-locking issues and ensures the add-in registers and loads correctly the next time Revit starts.

1. Prerequisites

  • Windows with Autodesk Revit installed (see supported versions).
  • An internet connection (the add-in talks to app.vitruai.com).
  • .NET runtimes — install any that are missing, or the add-in can fail to load:

You don't need an account before installing — you can sign up right inside the add-in on first launch (and create your firm, or join one you were invited to). See Getting started.

2. Download

Download the VitruAI installer from the official VitruAI download page. Always use the official build — do not run unofficial or development packages. (New to VitruAI? See plans and pricing.)

Windows SmartScreen — expected, and safe to bypass

The current build is not yet code-signed, so Windows SmartScreen shows a "Windows protected your PC" prompt (and the installer's admin prompt reads "Unknown publisher"). This is expected for a new publisher — not a sign anything is wrong. To continue: click More info → Run anyway. Full walkthrough: Troubleshooting → SmartScreen. (A code-signed build that removes this prompt is coming in a later release.)

Verify your download (optional)

Each release publishes a SHA-256 checksum next to the installer. To confirm your download is intact, run in PowerShell and compare against the published value: 

Get-FileHash -Algorithm SHA256 .\VitruAI-Setup.exe

3. Install

Run the installer and follow the setup wizard. It copies the application files, registers the Revit add-in, and configures the local components that let the agent talk to Revit and save reports.

What gets installed

Location What it is
C:\Program Files (x86)\VitruAI Root install folder — all components for the local workflow.
C:\Program Files (x86)\VitruAI\revit-addin The Revit add-in files Revit loads.
C:\Program Files (x86)\VitruAI\revit.proxy Bridges the agent to your locally installed Revit instance (sends commands, returns results).
C:\Program Files (x86)\VitruAI\reports.proxy Lets the agent save verification results to local storage.
%APPDATA%\VitruAI User-specific service data.
%APPDATA%\VitruAI\Logs Diagnostic logs — useful for troubleshooting.
%APPDATA%\VitruAI\Reports Saved reports, incl. the local reports.json used by the Reports tab.
C:\ProgramData\Autodesk\Revit\Addins\<year> The .addin manifest that registers VitruAI in Revit.

4. Supported Revit versions

VitruAI targets Revit 2024, 2025, and 2026. The add-in manifest is registered under the matching C:\ProgramData\Autodesk\Revit\Addins\<year> folder. If you run multiple Revit versions, the installer registers the add-in for the supported versions it finds.

Check your version

In Revit, File → About shows the version. If the VitruAI ribbon tab does not appear after install, see the add-in isn't loading.

5. First launch

  1. Start Autodesk Revit and open a project.
  2. The VitruAI tab should appear in the Revit ribbon.
  3. Click the VitruAI button to launch it, then sign in or sign up.

Continue with Getting started to sign in and run your first check.

Updating

To update, download the latest installer from the download page and run it over your existing install (close Revit first, same as a fresh install). Check the release notes for what changed. (An in-app "update available" prompt is planned for a later release.)