Executive Overview
OkPy is an automation-development environment and AI-assisted tool builder that runs inside Autodesk Revit through the Orkestra add-in. It is designed to let AEC professionals create working Revit utilities—including their user interfaces and back-end logic—without building and packaging a conventional compiled add-in from scratch. Users can write tools directly, ask the OkPy Agent to generate them from plain-language requirements, test them against a Revit model, save them as portable OkPy files, and deploy approved tools locally or through Orkestra.
OkPy is broader than a fixed collection of commands. It combines three related offerings: a development environment for custom automation; an AI Agent that generates and revises tools; and a public library of ready-made Revit utilities. Orkestra supplies the host integration, ribbon access, tool distribution, analytics, permissions, and enterprise deployment layer. This makes OkPy most comparable to a low-code development platform, scripting environment, and AI coding assistant combined—not to a single-purpose Revit plug-in.
The product's key promise is to shorten the path from an automation idea to a repeatable, deployable Revit command. Its key risk is equally important: generated or user-written code can modify live project data at scale. Successful adoption therefore depends on testing, code review, release control, model backups, and clear separation between experimental and production tools.
Product Architecture
OkPy Editor
The full editor is aimed at tool creators. It combines a code editor, automatically generated input controls, a debugging console, result handling, and tool metadata in one environment. Current Revit documentation begins new tools in C#, while OkPy's broader documentation and history also describe Python and CPython-based development. Existing scripts may therefore require interpreter-specific review when moving between Revit generations.
OkPy Agent
The Agent provides a simplified conversational workflow. A user describes the Revit task, desired controls, and output; the Agent asks clarifying questions when needed, drafts the code and interface, and presents the result for testing. Published examples include a modeless Door Summary dashboard and a grid-renumbering utility. The generated result is a deterministic tool that can be saved and rerun, rather than a one-time chat response.
Orkestra Integration
OkPy ships with Orkestra and opens from the Orkestra ribbon tab in Revit. Orkestra can organize OkPy, Dynamo, and Grasshopper automations, place approved commands on Revit ribbons through Quick Access, distribute content across a firm, manage environments, and provide analytics. Local OkPy creation can be used independently, while organization-wide cloud deployment and management depend on Orkestra services and plan entitlements.

























