export-dynamo-file

Export Dynamo Graph File (.dyn)

Generate a complete, openable Dynamo .dyn file for:

"$ARGUMENTS"

What this produces

A .dyn file is a Dynamo graph saved as JSON. When the user opens it in Dynamo (File → Open or double-click), they get a ready-to-run graph with a Python Script node pre-filled with the generated code — no manual node creation or copy-pasting required.

Workflow

1. First, generate the Python script for the task (follow all guidelines from generate-dynamo skill — boilerplate imports, transactions, error handling, OUT=result).

2. Then wrap it in a valid .dyn file using the template below.

3. If you have file system access (Cowork / Claude Code), save the .dyn file directly to the user's desktop or a path they specify. Otherwise, output the complete JSON so they can save it manually as scriptname.dyn.

.dyn file template

Build the JSON programmatically — never try to manually JSON-escape multi-line Python code by hand. Instead, use Python's json.dumps() to produce the correct JSON string, or build the structure as a dict and serialize it. Here is the canonical template:

import json, uuid

# The Python script to embed (write the full script as a normal Python string here)
python_code = """
import clr
clr.AddReference('RevitServices')
from RevitServices.Persistence import DocumentManager
from RevitServices.Transactions import TransactionManager
clr.AddReference('RevitAPI')
from Autodesk.Revit.DB import *

doc = DocumentManager.Instance.CurrentDBDocument

try:
    # --- generated logic here ---
    result = []
    OUT = result
except Exception as e:
    import traceback
    OUT = 'ERROR: ' + str(e) + '\\n' + traceback.format_exc()
""".strip()

# Unique IDs for the graph and nodes
graph_id   = str(uuid.uuid4())
node_id    = str(uuid.uuid4())

graph = {
    "Uuid": graph_id,
    "IsCustomNode": False,
    "Description": "Generated by revit-bim Claude plugin",
    "Name": "BIM Script",          # ← set to a meaningful name based on the task
    "ElementResolver": {"ResolutionMap": {}},
    "Inputs": [],
    "Outputs": [],
    "Nodes": [
        {
            "ConcreteType": "PythonNodeModels.PythonNode, PythonNodeModels",
            "NodeType": "PythonScriptNode",
            "Code": python_code,    # json.dumps handles escaping automatically
            "Engine": "IronPython2",
            "EngineName": "IronPython2",
            "VariableInputPorts": True,
            "Id": node_id,
            "Inputs": [
                {
                    "Id": "in0",
                    "Name": "IN[0]",
                    "Description": "Input #0",
                    "UsingDefaultValue": False,
                    "Level": 2,
                    "UseLevels": False,
                    "KeepListStructure": False
                }
            ],
            "Outputs": [
                {
                    "Id": "out0",
                    "Name": "OUT",
                    "Description": "Result of the python script",
                    "UsingDefaultValue": False,
                    "Level": 2,
                    "UseLevels": False,
                    "KeepListStructure": False
                }
            ],
            "Replication": "Disabled",
            "Description": "Runs an embedded Python script."
        }
    ],
    "Connectors": [],
    "Dependencies": [],
    "NodeLibraryDependencies": [],
    "EnableLaceByDefault": True,
    "Bindings": [],
    "View": {
        "Dynamo": {
            "ScaleFactor": 1.0,
            "HasRunWithoutCrash": False,
            "IsVisibleInDynamoLibrary": True,
            "Version": "2.13.1.3887",
            "RunType": "Manual",
            "RunPeriod": "1000"
        },
        "Camera": {
            "Name": "Background Preview",
            "EyeX": -17.0, "EyeY": 24.0, "EyeZ": 50.0,
            "LookX": 12.0, "LookY": -13.0, "LookZ": -58.0,
            "UpX": 0.0, "UpY": 1.0, "UpZ": 0.0
        },
        "NodeViews": [
            {
                "Name": "Python Script",
                "ShowGeometry": True,
                "Id": node_id,
                "IsSetAsInput": False,
                "IsSetAsOutput": False,
                "Excluded": False,
                "X": 250.0,
                "Y": 100.0
            }
        ],
        "Annotations": [],
        "X": -100.0,
        "Y": -50.0,
        "Zoom": 1.0
    }
}

# Serialize to JSON with proper indentation and escaping
dyn_json = json.dumps(graph, indent=2, ensure_ascii=False)

# Save to file
output_path = r"C:\Users\YourName\Desktop\script_name.dyn"  # ← ask user or use a sensible default
with open(output_path, 'w', encoding='utf-8') as f:
    f.write(dyn_json)

print("Saved: " + output_path)