Skip to main content

​
Plugin Overview

Algomim plugins are lightweight extensions that run inside your design software. They create a secure connection between your running application and the Algomim web app, allowing the AI to execute commands directly in your model.

​
How Plugins Work

1

Plugin loads inside your software

When you start your design application, the Algomim plugin loads automatically.
2

You initiate a connection

Using a 6-digit PIN from the web app, the plugin establishes a secure WebSocket connection to Algomim’s cloud service.
3

AI sends commands, plugin executes

When you chat with Algomim, the AI generates code (C# for Revit/AutoCAD, Python for Rhino) and sends it to the plugin. The plugin compiles and executes the code inside your application’s API.
4

Results are sent back

The plugin sends execution results, screenshots, and data back to the web app so the AI can continue the conversation.

​
Available Plugins

PluginLanguageVersionsInstall Method
RevitC# (Roslyn)2024, 2025, 2026Installer (.exe)
AutoCADC# (Roslyn)2023, 2024, 2025, 2026Installer (.exe)
RhinoIronPython 2.77, 8Yak package manager
ArchiCADTypeScript28Coming soon

​
Key Concepts

​
PIN-Based Connection

Plugins connect using a temporary 6-digit PIN generated in the web app. This ensures:
  • Only you can connect to your session
  • No permanent credentials stored on your machine
  • PINs expire after 5 minutes for security

​
Script Execution

The AI writes and sends scripts to your software. Each plugin includes:
  • Script compiler/runner: Executes the AI-generated code in the application’s API context
  • Pre-validation: Catches common errors before execution (e.g., syntax issues, deprecated API calls)
  • Context variables: Provides the script with access to the current document, active view, and application objects

​
Available Tools

Each plugin exposes a set of tools to the AI:
ToolDescription
execute_scriptRun custom code in the application
get_selectionGet currently selected elements
capture_viewportTake a screenshot of the current view
search_revit_apiSearch the Revit API via reflection (Revit only)
The execute_script tool is the primary way Algomim interacts with your software. The AI writes code tailored to your specific request, compiles it, and runs it in real time.

​
Security & Safety

  • All connections use encrypted WebSocket (WSS)
  • Plugins only connect when you explicitly initiate a connection with a PIN
  • You can disconnect at any time
  • Always save your work before running AI-generated commands
  • Use Undo (Ctrl+Z) to reverse any unwanted changes