Autodesk Inventor desde código: primer experimento de automatización

Mg. Ing. Cesar Bobadilla · Ingeniero Colegiado · PMI · Docente & Consultor · Perú 2026

En el video que acompaña a este artículo se ve algo que al inicio parece raro: abro una terminal de Windows, ejecuto un archivo, y Autodesk Inventor responde dibujando geometría en un sketch que no existía un segundo antes. Nadie tocó el mouse. Este documento es la guía completa para que puedas reproducirlo en tu propia máquina, con los comandos exactos, el código, y los errores típicos que vas a encontrar en el camino.

Antes de entrar en los pasos, una nota de sinceridad: lo que hacemos aquí es pequeño. Una línea y un círculo en un sketch no resuelven ningún problema de ingeniería por sí solos. Pero es el primer ladrillo de un proyecto más grande: llegar al punto en que un equipo de diseño pueda generar familias completas de piezas a partir de datos, o incluso a partir de una descripción en lenguaje natural dada a un agente de IA. No estamos en ese punto. Pero el camino empieza aquí.

Recorrido visual paso a paso 1 / 13

‹ ›

Paso 1 · Preparación

Abre el Explorador de archivos en Documentos

Vamos a trabajar siempre dentro de C:\Users\TU_USUARIO\Documents. Aquí todavía no existe nuestra carpeta de experimento: en la lista ves Autodesk, Inventor y otras carpetas del sistema, pero no demoinv. Ese es el punto de partida.

Paso 2 · Preparación

Crea la carpeta demoinv

Clic derecho → Nuevo → Carpeta y la llamas demoinv (sin espacios, sin acentos, todo en minúsculas). Dentro de esta carpeta van a vivir los tres archivos del experimento: el código fuente, la DLL de Inventor y el ejecutable que vamos a generar.

Paso 3 · Descargar el código

Abre HolaMundo.cs en Google Drive

Ir al link de Google Drive y se abre una vista previa del archivo. No copies el texto de la vista previa: a veces pierde los saltos de línea. Lo que nos interesa es descargarlo tal cual.

Paso 4 · Descargar el código

Haz clic en el ícono de descarga

Ir al link de Google Drive y ahí, en la flecha hacia abajo, arriba a la izquierda, junto a Page 1/1. Si no la ves, mueve el mouse sobre la barra superior para que aparezca. Al hacer clic se abre el cuadro Guardar como.

Paso 5 · Descargar el código

Navega hasta la carpeta demoinv

En el cuadro Guardar como, entra a Documentos y abre demoinv. Verifica arriba que la ruta sea Documentos › demoinv. El nombre de archivo debe quedar exactamente como HolaMundo.cs (sin .txt al final).

Paso 6 · Descargar el código

Presiona Guardar

Confirma la descarga con el botón Guardar (abajo a la derecha). En segundos vas a ver el archivo dentro de la carpeta.

Paso 7 · Verificación

HolaMundo.cs ya vive en demoinv

Abre la carpeta demoinv para confirmar que el archivo aparece. Fíjate en la columna Tipo: debe decir Archivo CS, no Documento de texto. Si dice texto, el archivo se guardó mal y Windows le agregó .txt.

Paso 8 · Terminal

Abre el Símbolo del sistema

Haz clic en el botón de Windows (abajo a la izquierda), escribe cmd en el buscador y presiona Enter. También funciona presionar Windows + R, escribir cmd y dar Enter. Se abre una ventana negra: ese es tu espacio de trabajo de aquí en adelante.

Paso 9 · Terminal

Entra a Documents y verifica

Escribe cd Documents y presiona Enter. Luego dir para listar el contenido. Tienes que ver la carpeta demoinv en la lista — así confirmamos que estamos en el lugar correcto antes de seguir.

Paso 10 · DLL de Inventor

Localiza Autodesk.Inventor.Interop.dll

Ejecuta where /r "C:\Program Files\Autodesk" Autodesk.Inventor.Interop.dll. Windows lista todas las copias de la DLL. La que nos sirve es la que está en la ruta Public Assemblies (la subrayada en rojo). Cópiala: la vas a usar en el siguiente paso.

Paso 11 · DLL de Inventor

Copia la DLL a tu carpeta demoinv

Entra con cd demoinv y ejecuta copy "RUTA_DE_LA_DLL" . (el punto al final significa “aquí mismo”). Luego dir te tiene que mostrar los dos archivos: Autodesk.Inventor.Interop.dll y HolaMundo.cs. Sin la DLL al lado del código, el compilador no va a poder hablar con Inventor.
Usamos en este caso copy "C:\Program Files\Autodesk\Inventor 2026\Bin\Public Assemblies\Autodesk.Inventor.Interop.dll"

Paso 12 · Compilar

Genera Fase1.exe con csc.exe

Ejecuta una sola línea: "C:\Windows\Microsoft.NET\Framework64\v4.0.30319\csc.exe" /r:Autodesk.Inventor.Interop.dll /out:Fase1.exe HolaMundo.cs. Si no ves errores rojos, la compilación funcionó. Un dir después debe mostrar los tres archivos: la DLL, Fase1.exe y el código fuente.

Paso 13 · Resultado

Inventor dibuja solo

Doble clic en Fase1.exe (o escribe Fase1.exe en la misma terminal). Inventor se abre o toma el foco, crea un sketch nuevo y dibuja la línea y el círculo. Cuando veas aparecer el círculo morado en la pantalla: lo lograste. Este es el momento exacto del video.

1. Qué vas a hacer y qué necesitas

Vas a hacer un programa pequeño que, al ejecutarse, le pide a Autodesk Inventor lo siguiente:

• Abrir un documento de pieza nuevo (archivo .ipt).
• Crear un sketch en el plano XY.
• Dibujar una línea de (0, 0) a (50, 50) milímetros.
• Dibujar un círculo con centro en (100, 100) mm y radio 30 mm.

Y todo esto sin tocar un solo menú ni un solo botón. Eso es todo por ahora.

Lo que debes tener instalado

• Autodesk Inventor — cualquier versión reciente funciona. En mi máquina uso Inventor 2020; en otra tengo Inventor 2026.
• Windows con .NET Framework — ya viene incluido en Windows 10 y 11. No hay nada que instalar.
• Una terminal — CMD o PowerShell, cualquiera sirve.
• Un editor de texto — Notepad, Notepad++, VS Code, lo que tengas.

2. Cómo lo explico en una analogía

Inventor, además de su interfaz con menús y botones, tiene una puerta por la que acepta instrucciones desde otros programas. Pensárlo como una tomacorriente: siempre está energizada esperando que alguien conecte algo. Nuestro trabajo es escribir un programa que se conecte a esa puerta y le dicte lo que queremos. Ese dictado es en texto, en un lenguaje de programación llamado C# (se pronuncia cé sharp), y las instrucciones que podemos dar están documentadas por Autodesk en lo que se llama la API de Inventor.

¿Por qué C# y no otro lenguaje? Porque la API de Inventor está hecha para .NET, que es la familia de tecnologías en la que vive C# de forma nativa. Python también puede comunicarse con Inventor, pero con más fricción. En esta Fase 1 elijo el camino con menos sorpresas.

Localizar el compilador de C# en Windows

El compilador de C# se llama csc.exe (de C# Compiler). Su trabajo es tomar el archivo de texto que vas a escribir y convertirlo en un archivo .exe que Windows puede ejecutar. Como ya viene con el sistema, lo único que hace falta es saber dónde está.

Con el CMD abierto, escribe el siguiente comando y presiona Enter. Este comando le pide a Windows que busque el compilador csc.exe dentro de la carpeta de .NET y te muestre su ubicación exacta:

Conseguir el código fuente

Necesitas un archivo llamado HolaMundo.cs dentro de una carpeta nueva de experimento, por ejemplo C:\Users\TU_USUARIO\Documents\demoinv. Primero crea esa carpeta (clic derecho en el Explorador de archivos → Nuevo → Carpeta) y después elige uno de los dos caminos de abajo.

Crear carpeta demoinv 1 / 2

‹ ›

Paso 1

Crear la carpeta demoinv

En el Explorador de archivos crea una carpeta nueva.

Paso 2

Verificar que existe

Confirma que la carpeta demoinv fue creada.

Opción A · Descargar el código ya escrito (recomendado)

Si no quieres copiar y pegar — o si temes equivocarte en una coma y que luego el compilador te arroje errores confusos — puedes bajar el archivo ya listo desde cualquiera de estos dos lugares. Los dos tienen el mismo contenido; usa el que te quede más cómodo.

Descarga desde Google Drive 1 / 5

‹ ›

Paso 1

Abrir el archivo en Drive

Se abre la vista previa de HolaMundo.cs.

Paso 2

Presionar Descargar

Usa el ícono de flecha hacia abajo.

Paso 3

Elegir la carpeta demoinv

Guarda directamente dentro de demoinv.

Paso 4

Confirmar Guardar

Se descarga el archivo.

Paso 5

Verificar HolaMundo.cs

Debe aparecer dentro de la carpeta.

Con cualquiera de las dos opciones, tu carpeta demoinv debe terminar conteniendo un archivo llamado HolaMundo.cs. Ya puedes saltar al Paso 3.

Con cualquiera de las dos opciones, tu carpeta demoinv debe terminar conteniendo un archivo llamado HolaMundo.cs. Ya puedes saltar al Paso 3.

Opción B · Escribirlo a mano

Si quieres entender el código antes de ejecutarlo — o no tienes conexión estable ahora mismo — también puedes abrir el Bloc de notas de Windows (en el menú Inicio escribe notepad) y copiar adentro exactamente este contenido:

using System;
using System.Runtime.InteropServices;
using Inventor;  // Referencia a la API de Autodesk

namespace Fase1
{
    class Program
    {
        [STAThread]  // Obligatorio para comunicacion COM
        static void Main(string[] args)
        {
            Application _invApp = null;
            try
            {
                // CONEXION AL SERVIDOR COM
                // Intentamos capturar una instancia de Inventor ya abierta
                try {
                    _invApp = (Application)Marshal.GetActiveObject("Inventor.Application");
                } catch {
                    Console.WriteLine("Inventor no esta abierto. Abriendo una nueva sesion...");
                    Type invAppType = Type.GetTypeFromProgID("Inventor.Application");
                    _invApp = (Application)Activator.CreateInstance(invAppType);
                    _invApp.Visible = true;
                }

                // MANEJO DE UNIDADES: La API siempre usa cm.
                // Para hacer 50 mm, usaremos 5.0

                // Crear un documento de pieza (.ipt)
                PartDocument oDoc = (PartDocument)_invApp.Documents.Add(
                    DocumentTypeEnum.kPartDocumentObject,
                    _invApp.FileManager.GetTemplateFile(DocumentTypeEnum.kPartDocumentObject)
                );
                PartComponentDefinition oCompDef = oDoc.ComponentDefinition;
                TransientGeometry oTG = _invApp.TransientGeometry;

                // HITO: Dibujar en el plano XY (indice 3 en la coleccion de planos)
                PlanarSketch oSketch = oCompDef.Sketches.Add(oCompDef.WorkPlanes[3]);

                // Dibujar Linea (0,0 a 5,5 cm)
                oSketch.SketchLines.AddByTwoPoints(
                    oTG.CreatePoint2d(0, 0),
                    oTG.CreatePoint2d(5, 5)
                );

                // Dibujar Circulo (centro 10,10 cm, radio 3 cm)
                oSketch.SketchCircles.AddByCenterRadius(
                    oTG.CreatePoint2d(10, 10),
                    3
                );

                Console.WriteLine("Hito Fase 1 completado: Linea y Circulo creados.");
            }
            catch (Exception ex)
            {
                Console.WriteLine("Error critico: " + ex.Message);
            }
        }
    }
}

3. Cómo se lee ese código

No necesitas entender cada línea para correrlo, pero vale la pena pasar por los cinco bloques principales para que el experimento no se sienta mágico.

a. [STAThread]

Ese atributo arriba del método Main le dice a Windows que el programa va a hablar con un componente COM (que es el tipo de interfaz que expone Inventor). Sin ese atributo el programa falla con errores confusos. No necesitas entender más que eso: siempre que hables con Inventor, [STAThread] tiene que estar.

b. Conectarse a Inventor

El primer bloque dentro del try hace lo siguiente: intenta capturar una instancia de Inventor que ya esté abierta. Si no la encuentra, la abre él mismo y la hace visible. Este patrón es útil porque te permite correr el programa independientemente de si abriste Inventor antes o no.

c. Unidades: el gotcha más frecuente

La API de Inventor, por razones históricas, trabaja internamente en centímetros. Así que cuando en el código escribo el número 5, en pantalla el usuario va a ver 50 mm. Este es el detalle que más confunde al inicio y el que más vale la pena memorizar.

d. Crear el documento y el sketch

Con _invApp.Documents.Add(...) pedimos un documento nuevo de tipo parte (extensión .ipt), usando la plantilla por defecto de Inventor. Luego accedemos a sus planos de trabajo (WorkPlanes): el índice 3 corresponde al plano XY, que es el que solemos usar para los sketches horizontales.

e. Dibujar la geometría

AddByTwoPoints crea una línea entre dos puntos, y AddByCenterRadius crea un círculo a partir de un punto central y un radio. Los puntos los fabricamos con el objeto auxiliar TransientGeometry. El resultado — en milímetros — es una línea de (0, 0) a (50, 50) y un círculo de radio 30 mm centrado en (100, 100).

Ubicar la DLL de Inventor en tu versión

Para que nuestro código pueda decir "crea un sketch" o "dibuja un círculo" Inventor pone a disposición un diccionario llamado Autodesk.Inventor.Interop.dll. Ese archivo vive dentro de la carpeta de instalación de Inventor, y la ruta cambia según la versión que tengas instalada. Aquí va una nota de honestidad: cuando empecé, asumí que era Inventor 2026 y escribí esa ruta a ojo. Mi máquina tenía Inventor 2020. El compilador devolvió un error confuso y tuve que ir a buscar.

Este comando te busca el archivo en todas las carpetas de Autodesk que tengas:

Copia la ruta completa que te devuelva el comando. Si tienes varias versiones de Inventor instaladas, te aparecerán varias rutas; usa la que corresponde a la versión que vas a abrir.

Compilar

Ahora tenemos los tres ingredientes: la ruta del compilador, la ruta del diccionario DLL, y el archivo HolaMundo.cs. Los combinamos en un comando que le dice a csc.exe: "toma este código, úsalo con este diccionario, y devuelve un ejecutable llamado Fase1.exe".

Movete a la carpeta donde guardaste HolaMundo.cs y ejecuta (en una sola línea, reemplazando la ruta de la DLL por la que obtuviste en el paso anterior):

Si el comando termina sin mostrar errores en rojo, significa que se creó el archivo Fase1.exe en la misma carpeta. Inventor todavía no hizo nada — eso pasa en el paso siguiente.

Ejecutar y verificar

Sin cerrar la terminal, ejecuta el archivo que se acaba de crear:

Abre la ventana de Inventor. Deberías ver un documento de pieza nuevo con un sketch activo, una línea diagonal y un círculo. Si lo ves, el experimento funcionó. Si no, salta a la sección siguiente.

4. Errores típicos

"No se puede cargar el archivo o ensamblado Autodesk.Inventor.Interop"

Este es el error que más se repite cuando un alumno sigue la guía por primera vez. Compila sin problemas, pero al ejecutar Fase1.exe la consola se llena de texto rojo que se ve así:

Qué está pasando en palabras simples. Al compilar, le dijiste al compilador "usa el diccionario que está en C:\Program Files\...\Autodesk.Inventor.Interop.dll" (eso es el /r:). El compilador lo usó para armar tu Fase1.exe, pero no copió el diccionario adentro. Ahora, cuando ejecutas Fase1.exe, Windows necesita encontrar ese diccionario otra vez para que el programa funcione. Lo primero que hace Windows es buscarlo en la misma carpeta donde está tu .exe. Si no lo encuentra ahí, se rinde y lanza este error.

La solución, en una frase: copiar el archivo Autodesk.Inventor.Interop.dll dentro de tu carpeta demoinv, al lado de Fase1.exe. Tienes dos caminos para hacerlo; elige el que te sea más cómodo.

Cómo verificas que quedó bien. Abre la carpeta demoinv con el Explorador: ahora deben existir al menos tres archivos al mismo nivel: HolaMundo.cs, Fase1.exe y Autodesk.Inventor.Interop.dll. Si los tres están ahí, ejecuta nuevamente Fase1.exe desde el CMD y Inventor debería crear el sketch con la línea y el círculo.

"csc.exe no se reconoce como un comando"

Estás escribiendo la ruta del compilador sin comillas o sin la ruta completa. Recuerda: el comando comienza con las comillas dobles abarcando la ruta hasta csc.exe.

"Metadata file '...' could not be found"

La ruta de la DLL que pusiste en /r: no existe. Casi siempre es porque la versión de Inventor que asumiste no es la que tienes instalada. Usa el comando where /r del paso 3 para verificar.

"Retrieving the COM class factory failed"

No hay Inventor instalado en el sistema, o está instalado en una ruta no registrada. Verifica desde el menú Inicio de Windows que Inventor se abra manualmente. Si se abre, el problema es otro; si no, reinstala Inventor.

Inventor se abrió pero no veo ninguna ventana

Faltó la línea _invApp.Visible = true; o fue eliminada por error. En ese caso Inventor está corriendo en segundo plano sin mostrar su interfaz.

El ejecutable termina sin errores pero Inventor no muestra nada

Es posible que Inventor esté creando la pieza en una sesión distinta. Cierra todas las instancias de Inventor, vuelve a correr Fase1.exe desde cero, y observa.

5. ¿Puedo pedirle este código a una IA?

Sí. De hecho, el código que usé en el video lo generé conversando con Claude de Anthropic y ajustando lo que me dio. Para un primer experimento como este, pedirle a un asistente de IA que te genere el esqueleto y luego leerlo con calma es perfectamente válido; lo importante es que entiendas cada bloque antes de correrlo. Si corres un código que no entiendes, vas a perder más tiempo depurando que el que ahorraste genera´ndolo.

6. Qué se logró y hacia dónde va esto

Hoy tenemos un programa pequeño que controla Autodesk Inventor desde la terminal. Produce un sketch con dos formas y punto. Es chico. Y al mismo tiempo es el primer eslabón de una cadena que en las siguientes fases permite hacer varias cosas que sí impactan un flujo real de trabajo.

• Parametrizar. En vez de tener los números quemados dentro del código, pasarlos como argumentos para generar la misma pieza con medidas distintas. Generar una familia de cien placas con cien espesores desde un solo archivo Excel.
• Pasar a IA y ensambles. La Fase 2 ya muestra el siguiente salto: prompt → IA → C# → compilación → Inventor, con piezas y ensambles más complejos.
• Ensamblar y animar. Ya no una pieza suelta sino un ensamble con restricciones, y eventualmente una animación de movimiento. Inventor soporta todo eso por la misma API.
• Conectar con IA. Un asistente recibe un requerimiento escrito y genera el código correspondiente, que se compila y ejecuta sin intervención humana directa.

La continuación directa es la Fase 2, acompañada por su video en YouTube. Pero ninguna de esas fases funciona bien si primero no dominas el paso de hoy: que un comando en terminal cree geometría en una herramienta de CAD profesional. Ese es el eslabón uno.