Skip to content

Getting started

This walks you from a fresh install to your first saved verification report. It assumes the VitruAI add-in is already installed — if not, see the Install guide first.

1. Open VitruAI in Revit

  1. Open Autodesk Revit and load the project you want to check.
  2. On the Revit ribbon, open the VitruAI tab and click the VitruAI button. The VitruAI window opens.

2. Sign in or sign up

Sign in right inside the add-in. No account yet? You can create one here too — there's no separate website step:

  • Starting a new firm? Choose Sign up, create your account, then create your firm — you become its owner. (See Create your firm.)
  • Invited by a colleague? Open their invite link to join their firm.
  • Returning? Sign in:
    1. Enter your email.
    2. Pick your firm if your email belongs to more than one (otherwise VitruAI selects it).
    3. Enter your password (or continue with single sign-on if your firm uses it).
    4. Complete two-factor authentication if your firm has it enabled.

After you're in, VitruAI shares your session with the Revit add-in automatically, so the agent can reach the model in your open Revit instance.

Connecting more than one Revit machine

You can connect several Revit machines — or several open models — to the same account at the same time. Each is registered as its own connected device. When more than one is connected, a session picker appears so you choose which Revit instance a check targets. See Working with more than one Revit session.

3. Start a chat with the QAQC Coordinator

In VitruAI, start a new chat with the QAQC Coordinator — the agent that coordinates model verification. It reads your request, decides which checks to run, and uses the Revit connection to analyze the active model.

4. Run your first check

Ask the QAQC Coordinator to verify the active model against the rules you care about. You can describe rules directly in the chat, or rely on rules already configured for your project.

Example requests:

Check the active model and identify whether it contains bedroom rooms
with an area smaller than the required minimum.

Check the active model against rule №1.5.2.

Check all rooms in the model against the rules that define room-related restrictions.

the QAQC Coordinator analyzes the model and replies with a summary of findings — which rules passed, which failed, and the elements involved. (See Concepts for what the statuses mean.)

Want a saved, full report? Work inside a project

The chat always shows a summary. A durable, exportable report is written when your work is scoped to a project. If you're an admin setting projects up, see Projects & access.

5. Save the verification report

After a check, the QAQC Coordinator may ask whether to save the report. Confirm in the chat — the report is written to local Reports storage and appears in the Reports tab.

6. Review reports in the Reports tab

Open the Reports tab in the VitruAI window. Reports are listed in a left panel grouped by date (Today, Yesterday, 2 days ago, or a calendar date). Search by title, original prompt, or result summary.

Select a report to open it. Each report shows:

  • Overview — title, the Revit document, report ID, creation time, summary, and rule- and element-level statistics (Passed / Failed / Indeterminate / NeedInfo).
  • Details — expandable rule groups with a table of checked elements: status, the Revit element ID (with a copy button), the resolved element name (when Revit is available), and the result text.

Click an element row (or focus it and press Enter/Space) to select that element in the active Revit model. Click it again to clear the selection.

Report actions:

Action What it does
Recheck Opens a new chat with the original request, prior summary, and previously checked elements, so the QAQC Coordinator can re-verify after model changes.
Delete Removes the report after a confirmation.
Export → PDF Saves and opens a PDF of the report.
Export → Excel Saves and opens an .xlsx of the report.

Next steps

  • Concepts — understand rules, findings, reports, and the credit model.
  • Firm-admin guide — invite teammates, manage billing, set up projects and devices.
  • Troubleshooting & FAQ — if sign-in, the Revit connection, or a check doesn't behave as expected.