Skip to main content

Tutorial - Autodesk Revit

info

Level: Intermediate
Time: 30–45 min for one workflow

Prerequisites:

  • A VIKTOR account with App Builder access or the VIKTOR CLI for local development.
  • For App Builder, your environment administrator must enable Allow Python-based workers in the app builder.
  • Revit 2024 or newer, pyRevit 7.0 or newer, and VIKTOR Desktop on the same Windows computer.
  • An open Revit model. Use a writable copy for the workflows that change the model.

Introduction​

Build an app that works with the model you have open in Revit. Use the App Builder to color structural elements, measure concrete volumes, estimate wall carbon and cost, place room tags, dimension grids, or review doors. Each prompt creates a separate app. The Local development tab shows how to run the category coloring sample from GitHub.

1. Connect Revit to VIKTOR​

The VIKTOR Revit worker sends app requests to pyRevit, which runs them in the model you have open. Follow the steps below to set up both tools on the Windows computer that runs Revit. Revit integration guide

  1. Install pyRevit and attach it to your Revit version.
  2. Open Revit and enable the pyRevit Agent Runtime. Set Model Changes to Auto for this tutorial so app actions apply directly to your test model. Select Save Settings and Reload.
  3. Sign in to VIKTOR Desktop on the Windows computer that runs Revit. Use the same Windows account for both. Add a Revit worker, select its Python executable, and start the worker.
  4. Run pyrevit agent status in a terminal on that computer to check that the Agent Runtime can see Revit. In the VIKTOR app, open Integration status to check that the Revit worker is connected.

Use the Path to the Python executable field to select the Python installation for the worker.

VIKTOR Desktop configuration for the Revit worker

For the App Builder, your environment administrator must enable Allow Python-based workers in the app builder. If the App Builder asks about your setup, confirm that the worker is connected, the model is open, and Model Changes is set to Auto.

2. Open a sample model​

Each prompt names the Snowdon Towers model to open. Choose the link for your Revit version from 2024 through 2027. On the Autodesk sample files page, select Architectural or Structural under Snowdon Towers as specified in the prompt. Open the file on the Windows computer that runs the worker and keep the model active in Revit while you use the app. You can also use a model with the same categories and views.

3. Choose your approach​

Select the arrow on a prompt to open it in the App Builder. Check the generated inputs and the model shown in the app before you run an action. The app layout can differ from the examples below.

Prompt 1 – Color structural elements by category​

Give columns, framing, and floors different colors in one Revit view. Start here to check that VIKTOR can read the model and apply a visible change.

Open Snowdon Towers Sample Structural. Revit 2024 download · Revit 2025 sample files · Revit 2026 sample files · Revit 2027 sample files

Color structural elements in Revit

Open the Structure Only 3D view in the structural model. In the app, select Load views, choose Active view, and set a color for each category. Select Apply colors and check the element counts.

VIKTOR App Builder showing color controls and element counts for the Structure Only view

Check the same view in Revit. The example shows red columns, blue framing, and green floors.

Snowdon Towers structural model with red columns, blue framing, and green floors in Revit

Prompt 2 – Measure concrete volumes by type​

Compare concrete quantities for slab and wall types in one dashboard.

Open Snowdon Towers Sample Architectural. Revit 2024 download · Revit 2025 sample files · Revit 2026 sample files · Revit 2027 sample files

Measure Revit concrete volumes by type

Select Load Concrete Volumes to populate the dashboard. For a floor or wall with several materials, compare the reported volume with the concrete material volume in a Revit material takeoff.

VIKTOR App Builder dashboard with side-by-side bar charts and volume tables for slab and wall types

Prompt 3 – Estimate wall carbon and cost​

Use the modeled area of each basic wall type and the rates you enter to estimate its carbon and cost. Store the rates on the Revit type so you can read them again.

Open Snowdon Towers Sample Architectural. Revit 2024 download · Revit 2025 sample files · Revit 2026 sample files · Revit 2027 sample files

Estimate Revit wall carbon and cost

Select Load / Reload Wall Data to read the wall types, counts, and areas from Revit.

VIKTOR App Builder showing the loaded Revit wall types, counts, areas, and carbon and cost summary

Enter the rates directly in Wall Type Rates. Check that the totals update as you edit. An area of 6 m² at 20 kg CO₂e/m² and 30 USD/m² gives 120 kg CO₂e and 180 USD.

Select Save All Rates to Revit below the table.

After the app confirms the save, select a wall in Revit, open Edit Type, and check the three values under Data. Select Load / Reload Wall Data in the app to read the saved values again.

Snowdon Towers architectural model in Revit with the carbon code, carbon factor, and unit cost under Type Properties

Prompt 4 – Add missing room tags​

A room tag displays information from a room, such as its number or name, on a plan. Use the table to find rooms that still need a tag on the selected plan.

Open Snowdon Towers Sample Architectural. Revit 2024 download · Revit 2025 sample files · Revit 2026 sample files · Revit 2027 sample files

Find and place missing Revit room tags

Select Rooms - L1 - Block 37 in the architectural model. Place the missing tags, then open the plan and check the tags in Revit. Repeat the action and check that it adds zero tags. In the example run, the app showed eight tagged rooms.

VIKTOR App Builder table showing the tag status of eight rooms

In Revit, zoom in on the plan to check the tags against the room outlines. The close-up shows Commercial/Retail 105 and Residential Lobby 106.

Revit floor plan with room names and numbers on Rooms - L1 - Block 37

Prompt 5 – Dimension grids on a plan​

Add dimensions between selected grid pairs and verify their values in Revit.

Open Snowdon Towers Sample Architectural. Revit 2024 download · Revit 2025 sample files · Revit 2026 sample files · Revit 2027 sample files

Add Revit plan grid dimensions

On L2, try grid pairs 1–2, 1–3, and 1–4. Compare the table values with the dimensions in Revit. Repeat the action and check that the table shows the same three IDs.

VIKTOR App Builder table showing the three grid pairs and their dimension IDs

The L2 close-up shows all three dimension values in the project's units.

Revit L2 floor plan showing the three grid dimension values

Prompt 6 – Review doors​

Use the dashboard to find doors that need review and locate them in a 3D Revit view.

Open Snowdon Towers Sample Architectural. Revit 2024 download · Revit 2025 sample files · Revit 2026 sample files · Revit 2027 sample files

Snowdon Door Review

Run the door check and filter the results by level. Click Create 3D Review View in Revit. Open the view and use the door IDs from the table to verify a few of the colored doors.

VIKTOR App Builder showing door issues by level and the door width distribution

Conclusion​

Adapt one of the prompts to a model you work with. Change the categories, rates, or checks to suit your project, then verify the results in Revit.

For models stored in Autodesk Construction Cloud, try viewing a model, running a quantity takeoff, or checking element properties in the Autodesk Forma / ACC tutorial.