Converto — How to Use

Last Updated: January 1, 2026

Converto reads a Dynamo .dyn graph and generates a complete C# Revit API add-in scaffold — ready to compile and extend.

Prerequisites

Requirement Notes
Autodesk Revit 2026 Required to run the add-in
.NET 8 SDK Required to build generated scaffold projects
Visual Studio 2022 (optional) Recommended for editing generated code
Claude or OpenAI API key (optional) Required for AI-assisted code generation

Quick start

Step 1 — Open a Revit project

Launch Revit 2026 and open any project. Converto runs inside an active Revit session.

Step 2 — Open Converto

Go to the AvantLeap tab → CONVERTO panel → click Convert Graph.

Step 3 — Load your .dyn file

Click Browse next to the "Dynamo File" field and select your .dyn graph file.

Converto parses the graph and displays a node analysis table showing each node's:

Column Meaning
Node name The Dynamo node label
Status Mapped / Partial / NotMapped
Category How the node is grouped (Element, Filter, Parameter, View, etc.)
Proposed method The C# method name Converto will generate
API hint The Revit API equivalent (for Mapped nodes)

Step 4 — Review the mapping results

  • Mapped nodes have a direct C# Revit API translation. Their stubs will be pre-filled.
  • NotMapped nodes (third-party packages, Python scripts) generate stub methods with TODO comments. These require manual implementation or AI assistance.
  • If an API key is configured, click Suggest with AI to get AI-generated mapping hints for unmapped nodes.

Step 5 — Configure output settings

Field Description
Add-in name The name of the generated Visual Studio project and DLL
Namespace Root C# namespace (e.g., MyFirm.Tools)
Output folder Where the scaffold project folder will be written

Step 6 — Generate & Build

Click Generate & Build.

Converto will:

  1. Write the scaffold project to OutputFolder\{AddinName}\
  2. If an AI key is configured: ask the AI to implement all stub methods with real Revit API code
  3. Run dotnet build on the generated project
  4. If build errors occur: send the errors back to the AI and apply fixes (up to 3 iterations)
  5. Report the final build result in the log panel

A successful build produces a compiled .dll in {AddinName}\bin\Release\.

AI Settings

Click ⚙ AI Settings (visible in the top action bar) to configure your API key.

Setting Description
Provider Choose Claude (Anthropic) or OpenAI (GPT-4o)
API Key Your personal API key — stored locally, never sent to AvantLeap
Model Default: claude-sonnet-4-6 / gpt-4o
Auto-suggest unmapped Automatically query AI for unmapped node hints when loading a graph

Click Test Connection to verify your key before generating.

Validate Scaffold

Use the Validate Scaffold command (AvantLeap → CONVERTO → Validate) to build and fix an existing scaffold project without re-running the full conversion.

  1. Click Browse to select the scaffold .csproj file
  2. Click Build to run dotnet build and view errors
  3. Click Fix with AI to send errors to the AI and apply fixes
  4. Repeat until the build succeeds

Understanding the generated project

OutputFolder\
└── MyTool\
    ├── MyTool.csproj           ← SDK-style, net8.0-windows, RevitAPI refs
    ├── MyTool.addin            ← Revit manifest — copy to Addins folder
    ├── App.cs                  ← IExternalApplication + ribbon buttons
    ├── Nodes\
    │   ├── ElementNodes.cs     ← Static helper methods (one per node category)
    │   └── ...
    ├── Commands\
    │   ├── ElementCommand.cs   ← IExternalCommand per category
    │   └── ...
    └── README-converto.md      ← Quick-start for the generated project

Deploying the generated add-in

  1. Build the scaffold: dotnet build MyTool.csproj -c Release
  2. Copy bin\Release\MyTool.dll to %APPDATA%\Autodesk\Revit\Addins\2026\MyTool\
  3. Copy MyTool.addin to %APPDATA%\Autodesk\Revit\Addins\2026\
  4. Restart Revit

Mapping tiers

Tier Source Result
1 — Core Dynamo Built-in Dynamo/Revit nodes Mapped → pre-filled C# code
2 — Third-party package archilab, Clockwork, spring, BumbleBee, etc. NotMapped → stub + TODO comment
3 — Python Script PythonScriptNode NotMapped → stub with embedded Python script as comment

Tier 2 and 3 stubs are completed by the AI implementation step when an API key is available.

Troubleshooting

Issue Solution
"Test Connection: Failed" Check your API key is correct and has available credits. The full error is shown below the button.
Build errors after AI fix Click "Fix with AI" again — up to 3 automatic iterations are attempted. Complex graphs may need manual edits.
RevitAPI.dll not found Ensure Revit 2026 is installed at C:\Program Files\Autodesk\Revit 2026\
All nodes show NotMapped The graph likely uses only third-party packages. AI generation will handle most of these.
Generated ribbon button missing Check FullClassName in the .addin file matches the App class namespace exactly.

Supported Revit versions

Revit Supported
2026 Yes
2025 and earlier Phase 3 — coming soon

For support: https://www.avantleap.com/converto