Community-maintained Revit automation scripts for BIMO Run Python. The repository is designed for both direct use by Revit users and machine discovery by AI agents that execute approved scripts through BIMO MCP.
- Download or clone this repository.
- In Revit, open BIMO > Run Python and create a preset.
- Select the engine declared for the script in
catalog.json. - Leave the inline Script field empty and set Script file to the
.pyfile. - Add the documented
INvalues, prepare the required selection, and run the preset.
BIMO hosts the Python engine inside Revit, so users do not need a separate local Python installation just to run these scripts. Scripts that modify a model manage their own Revit transactions.
| Script | Category | Engine | Risk |
|---|---|---|---|
| Import image to active view | Documentation | IronPython | Writes model and optionally copies a file |
| Create Toposolid from model lines | Modeling | IronPython | Writes model |
| Create model-line contour from linked STL slice | Modeling | IronPython | Writes model and optionally reads local assemblies |
| Create Floors from shape-edited roofs | Modeling | IronPython | Writes model; dry run by default |
| Calculate selected lines length | Miscellaneous | IronPython | Read-only |
| Calculate element volume | Miscellaneous | IronPython | Read-only |
| Delete BIMO preview rays | Miscellaneous | IronPython | Deletes elements |
The authoritative machine-readable index is catalog.json. Its contract is defined by schemas/catalog.schema.json.
catalog.json Machine-readable script index
schemas/catalog.schema.json Catalog JSON Schema
docs/decisions/ Durable algorithm and architecture decisions
documentation/ View documentation and image scripts
modeling/ Model-creation and editing scripts
miscellaneous/ General-purpose scripts
tools/validate_catalog.py Dependency-free repository validator
.github/workflows/ Continuous validation
Every executable script has a paired Markdown file explaining selection requirements, inputs, output, supported Revit versions, and model-change risk. Existing script paths are kept stable so saved BIMO presets do not break.
An agent should:
- Filter
catalog.jsonby category, tags, engine, Revit version, and risk. - Read the script documentation before execution.
- Confirm required selection and inputs.
- Treat
writeanddestructivescripts as model-changing operations requiring explicit approval. - Load the exact file referenced by
pathand execute it through the supported BIMO Run Python or MCP operation. - Return the script's
OUTvalue or execution error without claiming success before Revit confirms it.
The catalog helps discovery; it is not an execution allowlist or a security boundary. Review scripts before running them and use a test model for model-changing operations.
See CONTRIBUTING.md for the script contract and submission checklist. Validate changes locally with:
python tools/validate_catalog.pyThe same check runs in GitHub Actions.
Distributed under the MIT License.
