ADMIN & AUTOMATION

Script Hub.

Drop a Python file into a folder and it becomes a button on the Revit ribbon — then drag and drop to arrange tabs, panels and groups right in the window, and apply without restarting Revit.

01 · THE PROBLEM

Every team that writes Revit scripts hits the same three problems: getting scripts onto the ribbon where colleagues can click them, rearranging where the buttons sit as the script count grows, and knowing who ran what. The most common platform today ties ribbon layout to the folder structure on disk, so every presentation change becomes a rename or a file move.

đổi tên thư mục

Moving one button to another panel means editing the folder tree

Ribbon layout is locked to folder names, so moving a button means renaming or relocating the whole script folder, then reloading. Whoever maintains the library has to memorise a naming convention instead of seeing the layout.

khởi động lại

After editing the config you often have to close and reopen Revit to see it

Quitting Revit with a large project open just to see a button you added costs ten minutes every time you try something.

không dấu vết

Scripts run and leave no trace behind

When the model changes the wrong way, nobody knows which script ran, from where, or which line failed — the only option is asking everyone on the team.

02 · FEATURES

What it does

Script Hub only provides the platform — running scripts and managing where they sit on the ribbon — so the script library stays yours, wherever you keep it and however you write it.

A

Running scripts

  • IronPython 3.4.2 runs inside the Revit process; scripts reach doc, uidoc and app directly
  • Reads existing pyRevit libraries as-is: .pushbutton folders, bundle.yaml, icon.png
  • Also takes single .py files, with metadata read from the docstring
  • Reports errors as a real Python traceback with the line number in your file
  • AI can run Python code or a .py file over MCP without opening the window — a run that fails midway is rolled back as a whole
B

Arranging the ribbon

  • Drag and drop to change tab, panel, group and order — the script folders stay untouched
  • Apply changes to the ribbon immediately, with no Revit restart
  • New files dropped into a folder still appear automatically, following the folder structure
  • Icons are generated when a script has none, and follow Revit's light and dark theme
C

Traceability and toggling

  • Click and it runs — no approval dialog in front of every script
  • A log of every run: which script, launched from the ribbon or the window, how long it took, and the outcome
  • Disable a script from the ribbon without deleting the file; re-enable and it returns to the same button
TOOL INTERFACE · RUNNING IN REVIT

Operational interface and functional overview

The interface is matched to the tool window running in Revit.

MORE IN THIS GROUP