pyrevitlabs · jmcouffin · Feb 16, 2026 · Feb 2, 2026 · Feb 3, 2026 · Feb 3, 2026
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -0,0 +1,158 @@
+# CLAUDE.md
+
+This file provides guidance for AI assistants working with the pyRevit codebase.
+
+## Project Overview
+
+pyRevit is a Rapid Application Development (RAD) environment for Autodesk Revit. It allows users to create automation tools and add-ins using Python (IronPython 2.7.12 default, CPython 3.12.3, or IronPython 3.4.0), C#, or VB.NET. The project includes a CLI utility for deployment and a telemetry server for usage tracking.
+
+## Repository Structure
+
+- `bin/` - Pre-built binaries (DLLs) and Python engines (IPY2712PR, IPY342, CPY3123)
+- `dev/` - C# source code, build scripts, and solution files
+- `docs/` - Documentation source for the website (mkdocs)
+- `extensions/` - pyRevit extensions (tools visible in Revit ribbon)
+- `extras/` - Additional resources (icons, dark mode generator)
+- `licenses/` - Third-party library licenses
+- `pyrevitlib/` - Python libraries for Revit API development
+- `release/` - Build artifacts and installer configurations
+- `site-packages/` - Third-party Python packages (must be IronPython 2.7.12 compatible)
+
+## Languages and Technologies
+
+- **Python**: IronPython 2.7.12 (default), CPython 3.12.3, IronPython 3.4.0
+- **C#**: .NET Framework 4.8 (Revit 2017-2024), .NET 8.0 (Revit 2025+)
+- **Go**: Telemetry server (`dev/pyRevitTelemetryServer/`)
+- **Build Tools**: Visual Studio 2022, pipenv, MSBuild, Inno Setup
+
+## Build Commands
+
+All build commands use pipenv. Run from the repository root:
+
+```bash
+# Setup environment
+pipenv install
+pipenv run pyrevit check              # Verify build environment
+
+# Build commands
+pipenv run pyrevit build products     # Build all C# DLLs (Release mode)
+pipenv run pyrevit build products Debug  # Build in Debug mode
+pipenv run pyrevit build labs         # Build main project only
+pipenv run pyrevit build engines      # Build Python engines
+pipenv run pyrevit build installers   # Create Inno Setup installers
+pipenv run pyrevit build telem        # Build telemetry server
+
+# Cleaning
+pipenv run pyrevit clean labs         # Clean build artifacts
+
+# Version management
+pipenv run pyrevit set version <ver>  # Set version number
+pipenv run pyrevit set build wip      # Set as work-in-progress
+pipenv run pyrevit set build release  # Set as release build
+```
+
+## Documentation
+
+- Main website: https://pyrevitlabs.io/
+- Technical docs: https://docs.pyrevitlabs.io/ (mkdocs, built from `docs/` folder)
+
+```bash
+pipenv run docs                       # Build documentation (mkdocs)
+pipenv run check-docstrings           # Lint docstrings with ruff
+```
+
+## Testing
+
+```bash
+# Test telemetry server (requires Docker)
+pipenv run pyrevit test telem
+
+# Python unit tests are in pyrevitlib/pyrevit/unittests/
+# C# unit tests are in dev/pyRevitLabs/pyRevitLabs.UnitTests/
+```
+
+To test in Revit:
+```bash
+pyrevit clones add dev <path-to-repo>
+pyrevit attach dev default --installed
+```
+
+## Development Workflow
+
+1. Fork and clone the repository
+2. Checkout `develop` branch (active development)
+3. Initialize submodules: `git submodule update --init --recursive`
+4. Install dependencies: `pipenv install`
+5. Build: `pipenv run pyrevit build products Debug`
+6. Test in Revit by attaching the clone
+
+For debugging C# code:
+1. Build in Debug mode
+2. Open the appropriate `.sln` file in Visual Studio
+3. Attach debugger to `revit.exe` process
+
+## Architecture Overview
+
+### Loading Sequence
+1. Revit reads `.addin` manifest from Addins folder
+2. Manifest points to `pyRevitLoader.dll` (C#)
+3. Loader launches `pyrevitloader.py` in IronPython
+4. Python script calls `pyrevit.loader.sessionmgr.load_session()`
+5. Extensions are discovered and UI is built
+
+### Key Components
+- **pyRevitLoader** (`dev/pyRevitLoader/`): Revit add-in entry point
+- **PyRevit.Runtime** (`dev/pyRevitLabs/pyRevitLabs.PyRevit.Runtime/`): Command execution
+- **pyrevitlib** (`pyrevitlib/pyrevit/`): Python API for scripts
+- **CLI** (`dev/pyRevitLabs/pyRevitLabs.PyRevit/`): Command-line management
+
+### Script Engines
+Located in `dev/pyRevitLabs/pyRevitLabs.PyRevit.Runtime/`:
+- `IronPythonEngine.cs` - Default Python engine
+- `CPythonEngine.cs` - Modern Python (3.12)
+- `CLREngine.cs` - C#/VB.NET execution
+- `DynamoBIMEngine.cs` - Dynamo graphs
+- `GrasshopperEngine.cs` - Grasshopper definitions
+
+## Extension Bundle Structure
+
+Extensions follow this hierarchy:
+```
+MyExtension.extension/
+  MyTab.tab/
+    MyPanel.panel/
+      MyButton.pushbutton/
+        bundle.yaml      # Button configuration
+        script.py        # Python script
+        icon.png         # Button icon
+```
+
+Supported bundle types: pushbutton, smartbutton, pulldown, splitbutton, panelbutton
+
+## Key Configuration Files
+
+- `Pipfile` - Python dependencies (requires Python 3.10)
+- `pyRevitfile` - Engine definitions and deployment profiles
+- `pyproject.toml` - Ruff linting config (Google docstring convention)
+- `mkdocs.yml` - Documentation generation
+- `.gitmodules` - Git submodules for dependencies
+
+## Code Style
+
+- Python: Google docstring convention, formatted with black, linted with ruff
+- C#: Standard .NET conventions
+
+## Supported Revit Versions
+
+2017-2027, with separate builds per version:
+- Revit 2017-2024: .NET Framework 4.7.2/4.8
+- Revit 2025-2026: .NET 8.0
+- Revit 202ù: .NET 10.0
+
+## Git Workflow
+
+- `develop` branch: Active development (always start here)
+- `master` branch: Release material only
+- `docs` branch: Documentation website
+- Feature branches from `develop`, PRs back to `develop`
+- Run `git submodule update` after switching branches
diff --git a/bin/netcore/engines/IPY2712PR/pyRevitAssemblyBuilder.dll b/bin/netcore/engines/IPY2712PR/pyRevitAssemblyBuilder.dll
diff --git a/bin/netcore/engines/IPY2712PR/pyRevitExtensionParser.dll b/bin/netcore/engines/IPY2712PR/pyRevitExtensionParser.dll
diff --git a/bin/netcore/engines/IPY2712PR/pyRevitLabs.PyRevit.Runtime.2025.dll b/bin/netcore/engines/IPY2712PR/pyRevitLabs.PyRevit.Runtime.2025.dll
diff --git a/bin/netcore/engines/IPY2712PR/pyRevitLabs.PyRevit.Runtime.2026.dll b/bin/netcore/engines/IPY2712PR/pyRevitLabs.PyRevit.Runtime.2026.dll
diff --git a/bin/netcore/engines/IPY2712PR/pyRevitLabs.PyRevit.Runtime.2027.dll b/bin/netcore/engines/IPY2712PR/pyRevitLabs.PyRevit.Runtime.2027.dll
diff --git a/bin/netcore/engines/IPY2712PR/pyRevitLoader.dll b/bin/netcore/engines/IPY2712PR/pyRevitLoader.dll
diff --git a/bin/netcore/engines/IPY2712PR/pyRevitRunner.dll b/bin/netcore/engines/IPY2712PR/pyRevitRunner.dll
diff --git a/bin/netcore/engines/IPY342/pyRevitAssemblyBuilder.dll b/bin/netcore/engines/IPY342/pyRevitAssemblyBuilder.dll
diff --git a/bin/netcore/engines/IPY342/pyRevitExtensionParser.dll b/bin/netcore/engines/IPY342/pyRevitExtensionParser.dll
diff --git a/bin/netcore/engines/IPY342/pyRevitLabs.PyRevit.Runtime.2025.dll b/bin/netcore/engines/IPY342/pyRevitLabs.PyRevit.Runtime.2025.dll
diff --git a/bin/netcore/engines/IPY342/pyRevitLabs.PyRevit.Runtime.2026.dll b/bin/netcore/engines/IPY342/pyRevitLabs.PyRevit.Runtime.2026.dll
diff --git a/bin/netcore/engines/IPY342/pyRevitLabs.PyRevit.Runtime.2027.dll b/bin/netcore/engines/IPY342/pyRevitLabs.PyRevit.Runtime.2027.dll
diff --git a/bin/netcore/engines/IPY342/pyRevitLoader.dll b/bin/netcore/engines/IPY342/pyRevitLoader.dll
diff --git a/bin/netcore/engines/IPY342/pyRevitRunner.dll b/bin/netcore/engines/IPY342/pyRevitRunner.dll
diff --git a/bin/netcore/pyRevitLabs.Common.dll b/bin/netcore/pyRevitLabs.Common.dll
diff --git a/bin/netcore/pyRevitLabs.CommonCLI.dll b/bin/netcore/pyRevitLabs.CommonCLI.dll
diff --git a/bin/netcore/pyRevitLabs.CommonWPF.dll b/bin/netcore/pyRevitLabs.CommonWPF.dll
diff --git a/bin/netcore/pyRevitLabs.DeffrelDB.dll b/bin/netcore/pyRevitLabs.DeffrelDB.dll
diff --git a/bin/netcore/pyRevitLabs.Emojis.dll b/bin/netcore/pyRevitLabs.Emojis.dll
diff --git a/bin/netcore/pyRevitLabs.Language.dll b/bin/netcore/pyRevitLabs.Language.dll
diff --git a/bin/netcore/pyRevitLabs.PyRevit.Runtime.Shared.dll b/bin/netcore/pyRevitLabs.PyRevit.Runtime.Shared.dll
diff --git a/bin/netcore/pyRevitLabs.PyRevit.dll b/bin/netcore/pyRevitLabs.PyRevit.dll
diff --git a/bin/netcore/pyRevitLabs.TargetApps.AutoCAD.dll b/bin/netcore/pyRevitLabs.TargetApps.AutoCAD.dll
diff --git a/bin/netcore/pyRevitLabs.TargetApps.Navisworks.dll b/bin/netcore/pyRevitLabs.TargetApps.Navisworks.dll
diff --git a/bin/netcore/pyRevitLabs.TargetApps.Revit.dll b/bin/netcore/pyRevitLabs.TargetApps.Revit.dll
diff --git a/bin/netcore/pyRevitLabs.UnitTests.dll b/bin/netcore/pyRevitLabs.UnitTests.dll
diff --git a/bin/netfx/engines/IPY2712PR/pyRevitAssemblyBuilder.dll b/bin/netfx/engines/IPY2712PR/pyRevitAssemblyBuilder.dll
diff --git a/bin/netfx/engines/IPY2712PR/pyRevitExtensionParser.dll b/bin/netfx/engines/IPY2712PR/pyRevitExtensionParser.dll
diff --git a/bin/netfx/engines/IPY2712PR/pyRevitLabs.PyRevit.Runtime.2017.dll b/bin/netfx/engines/IPY2712PR/pyRevitLabs.PyRevit.Runtime.2017.dll
diff --git a/bin/netfx/engines/IPY2712PR/pyRevitLabs.PyRevit.Runtime.2018.dll b/bin/netfx/engines/IPY2712PR/pyRevitLabs.PyRevit.Runtime.2018.dll
diff --git a/bin/netfx/engines/IPY2712PR/pyRevitLabs.PyRevit.Runtime.2019.dll b/bin/netfx/engines/IPY2712PR/pyRevitLabs.PyRevit.Runtime.2019.dll
diff --git a/bin/netfx/engines/IPY2712PR/pyRevitLabs.PyRevit.Runtime.2020.dll b/bin/netfx/engines/IPY2712PR/pyRevitLabs.PyRevit.Runtime.2020.dll
diff --git a/bin/netfx/engines/IPY2712PR/pyRevitLabs.PyRevit.Runtime.2021.dll b/bin/netfx/engines/IPY2712PR/pyRevitLabs.PyRevit.Runtime.2021.dll
diff --git a/bin/netfx/engines/IPY2712PR/pyRevitLabs.PyRevit.Runtime.2022.dll b/bin/netfx/engines/IPY2712PR/pyRevitLabs.PyRevit.Runtime.2022.dll
diff --git a/bin/netfx/engines/IPY2712PR/pyRevitLabs.PyRevit.Runtime.2023.dll b/bin/netfx/engines/IPY2712PR/pyRevitLabs.PyRevit.Runtime.2023.dll
diff --git a/bin/netfx/engines/IPY2712PR/pyRevitLabs.PyRevit.Runtime.2024.dll b/bin/netfx/engines/IPY2712PR/pyRevitLabs.PyRevit.Runtime.2024.dll
diff --git a/bin/netfx/engines/IPY2712PR/pyRevitLoader.dll b/bin/netfx/engines/IPY2712PR/pyRevitLoader.dll
diff --git a/bin/netfx/engines/IPY2712PR/pyRevitRunner.dll b/bin/netfx/engines/IPY2712PR/pyRevitRunner.dll
diff --git a/bin/netfx/engines/IPY342/pyRevitAssemblyBuilder.dll b/bin/netfx/engines/IPY342/pyRevitAssemblyBuilder.dll
diff --git a/bin/netfx/engines/IPY342/pyRevitExtensionParser.dll b/bin/netfx/engines/IPY342/pyRevitExtensionParser.dll
diff --git a/bin/netfx/engines/IPY342/pyRevitLabs.PyRevit.Runtime.2017.dll b/bin/netfx/engines/IPY342/pyRevitLabs.PyRevit.Runtime.2017.dll
diff --git a/bin/netfx/engines/IPY342/pyRevitLabs.PyRevit.Runtime.2018.dll b/bin/netfx/engines/IPY342/pyRevitLabs.PyRevit.Runtime.2018.dll
diff --git a/bin/netfx/engines/IPY342/pyRevitLabs.PyRevit.Runtime.2019.dll b/bin/netfx/engines/IPY342/pyRevitLabs.PyRevit.Runtime.2019.dll
diff --git a/bin/netfx/engines/IPY342/pyRevitLabs.PyRevit.Runtime.2020.dll b/bin/netfx/engines/IPY342/pyRevitLabs.PyRevit.Runtime.2020.dll
diff --git a/bin/netfx/engines/IPY342/pyRevitLabs.PyRevit.Runtime.2021.dll b/bin/netfx/engines/IPY342/pyRevitLabs.PyRevit.Runtime.2021.dll
diff --git a/bin/netfx/engines/IPY342/pyRevitLabs.PyRevit.Runtime.2022.dll b/bin/netfx/engines/IPY342/pyRevitLabs.PyRevit.Runtime.2022.dll
diff --git a/bin/netfx/engines/IPY342/pyRevitLabs.PyRevit.Runtime.2023.dll b/bin/netfx/engines/IPY342/pyRevitLabs.PyRevit.Runtime.2023.dll
diff --git a/bin/netfx/engines/IPY342/pyRevitLabs.PyRevit.Runtime.2024.dll b/bin/netfx/engines/IPY342/pyRevitLabs.PyRevit.Runtime.2024.dll
diff --git a/bin/netfx/engines/IPY342/pyRevitLoader.dll b/bin/netfx/engines/IPY342/pyRevitLoader.dll
diff --git a/bin/netfx/engines/IPY342/pyRevitRunner.dll b/bin/netfx/engines/IPY342/pyRevitRunner.dll
diff --git a/bin/netfx/pyRevitLabs.Common.dll b/bin/netfx/pyRevitLabs.Common.dll
diff --git a/bin/netfx/pyRevitLabs.CommonCLI.dll b/bin/netfx/pyRevitLabs.CommonCLI.dll
diff --git a/bin/netfx/pyRevitLabs.CommonWPF.dll b/bin/netfx/pyRevitLabs.CommonWPF.dll
diff --git a/bin/netfx/pyRevitLabs.DeffrelDB.dll b/bin/netfx/pyRevitLabs.DeffrelDB.dll
diff --git a/bin/netfx/pyRevitLabs.Emojis.dll b/bin/netfx/pyRevitLabs.Emojis.dll
diff --git a/bin/netfx/pyRevitLabs.Language.dll b/bin/netfx/pyRevitLabs.Language.dll
diff --git a/bin/netfx/pyRevitLabs.PyRevit.Runtime.Shared.dll b/bin/netfx/pyRevitLabs.PyRevit.Runtime.Shared.dll
diff --git a/bin/netfx/pyRevitLabs.PyRevit.dll b/bin/netfx/pyRevitLabs.PyRevit.dll
diff --git a/bin/netfx/pyRevitLabs.TargetApps.AutoCAD.dll b/bin/netfx/pyRevitLabs.TargetApps.AutoCAD.dll
diff --git a/bin/netfx/pyRevitLabs.TargetApps.Navisworks.dll b/bin/netfx/pyRevitLabs.TargetApps.Navisworks.dll
diff --git a/bin/netfx/pyRevitLabs.TargetApps.Revit.dll b/bin/netfx/pyRevitLabs.TargetApps.Revit.dll
diff --git a/bin/netfx/pyRevitLabs.UnitTests.dll b/bin/netfx/pyRevitLabs.UnitTests.dll
diff --git a/bin/pyRevitLabs.Common.dll b/bin/pyRevitLabs.Common.dll
diff --git a/bin/pyRevitLabs.CommonCLI.dll b/bin/pyRevitLabs.CommonCLI.dll
diff --git a/bin/pyRevitLabs.CommonWPF.dll b/bin/pyRevitLabs.CommonWPF.dll
diff --git a/bin/pyRevitLabs.Language.dll b/bin/pyRevitLabs.Language.dll
diff --git a/bin/pyRevitLabs.PyRevit.dll b/bin/pyRevitLabs.PyRevit.dll
diff --git a/bin/pyRevitLabs.TargetApps.Revit.dll b/bin/pyRevitLabs.TargetApps.Revit.dll
diff --git a/bin/pyrevit-autocomplete.exe b/bin/pyrevit-autocomplete.exe
diff --git a/bin/pyrevit-doctor.dll b/bin/pyrevit-doctor.dll
diff --git a/bin/pyrevit-doctor.exe b/bin/pyrevit-doctor.exe
diff --git a/bin/pyrevit.dll b/bin/pyrevit.dll
diff --git a/bin/pyrevit.exe b/bin/pyrevit.exe
diff --git a/bin/pyrevit.runtimeconfig.json b/bin/pyrevit.runtimeconfig.json
@@ -12,6 +12,7 @@
       }
     ],
     "configProperties": {
+      "System.Reflection.Metadata.MetadataUpdater.IsSupported": false,
       "System.Runtime.Serialization.EnableUnsafeBinaryFormatterSerialization": false,
       "CSWINRT_USE_WINDOWS_UI_XAML_PROJECTIONS": false
     }

diff --git a/dev/Directory.Build.props b/dev/Directory.Build.props
@@ -17,7 +17,7 @@
   </PropertyGroup>
 
   <PropertyGroup>
-    <Version>6.0.0.26032+2040</Version>
+    <Version>6.1.0.26047+2349</Version>
     <Copyright>Copyright © 2014-2025</Copyright>
     <Company>pyRevitLabs.io</Company>
   </PropertyGroup>

diff --git a/dev/pyRevitLabs.PyRevit.Runtime/scriptruntime.cs b/dev/pyRevitLabs.PyRevit.Runtime/scriptruntime.cs
@@ -232,12 +232,24 @@ public ScriptEngineType EngineType {
                 if (string.IsNullOrEmpty(engineTypeName))
                     return null;
 
+                // Only honor Python engine overrides for Python scripts
+                if (!PyRevitScript.IsType(ScriptSourceFile, PyRevitScriptTypes.Python))
+                    return null;
+
                 // Map string to ScriptEngineType enum
-                if (engineTypeName.Equals("CPython", StringComparison.OrdinalIgnoreCase)) 
+                if (engineTypeName.Equals("CPython", StringComparison.OrdinalIgnoreCase))
                     return ScriptEngineType.CPython;
 
-                if (engineTypeName.Equals("IronPython", StringComparison.OrdinalIgnoreCase))
+                if (engineTypeName.Equals("IronPython", StringComparison.OrdinalIgnoreCase)) {
+                    // Backward-compat: older command generators always injected
+                    // "type":"IronPython" even when user did not explicitly set it.
+                    // In that case, allow runtime shebang detection to pick engine.
+                    var typeExplicit = json["type_explicit"]?.Value<bool?>() ?? false;
+                    if (!typeExplicit)
+                        return null;
+
                     return ScriptEngineType.IronPython;
+                }
 
                 return null;
             }