Installation

Complete installation instructions for Conjure adapters on FreeCAD and Fusion 360.

Overview

Conjure integrates with your CAD software through lightweight adapters. These adapters run inside your CAD application and communicate with the Conjure server to execute AI-generated commands.

Choose your CAD platform below for detailed installation instructions.

System Requirements

Minimum Requirements

  • Operating System: Windows 10/11, macOS 11+, or Linux (Ubuntu 20.04+)
  • Internet Connection: Required for AI operations
  • Disk Space: 50-100MB for adapter installation
  • CAD Software: FreeCAD 0.20+ or Fusion 360
Note: A Conjure account and API key is required. Sign up for free if you haven't already.

FreeCAD Installation

Quick Install (Recommended)

The quickest way to install the FreeCAD adapter is using our installation script:

Linux / macOS

curl -sSL https://conjure.lautrek.com/install.sh | bash

Windows (PowerShell)

iwr -useb https://conjure.lautrek.com/install.ps1 | iex

Manual Installation

  1. Download the adapter: freecad-adapter-latest.zip
  2. Extract the archive to your FreeCAD Mod directory:
    • Linux: ~/.local/share/FreeCAD/Mod/conjure/
    • macOS: ~/Library/Application Support/FreeCAD/Mod/conjure/
    • Windows: %APPDATA%\FreeCAD\Mod\conjure\
  3. Restart FreeCAD completely
  4. Verify installation: Open FreeCAD and check View → Workbench - you should see "Conjure" in the list
Tip: If you don't see the Mod directory, create it manually. FreeCAD will automatically load any workbenches placed there.

Fusion 360 Installation

Important: Fusion 360 support is currently in beta. Some features may be limited compared to FreeCAD.
  1. Download the add-in: fusion360-addin-latest.zip
  2. Extract the archive to a permanent location on your computer (e.g., Documents/Fusion360Addins/Conjure/)
  3. Open Fusion 360 and navigate to the Scripts and Add-ins panel:
    • Click Tools → Add-Ins → Scripts and Add-Ins
    • Or press Shift+S
  4. Add the Conjure add-in:
    • Click the + (green plus) button next to "My Add-Ins"
    • Navigate to and select the extracted Conjure folder
  5. Run the add-in:
    • Select "Conjure" from the add-ins list
    • Click Run
    • Optionally, check "Run on Startup" to auto-start the add-in
  6. Verify installation: You should see a Conjure panel in the Fusion 360 interface

Configuration

After installation, you'll need to configure your adapter with your Conjure API key:

First-Time Setup

  1. Open your CAD software (FreeCAD or Fusion 360)
  2. Launch the Conjure adapter (switch to Conjure workbench in FreeCAD, or click the Conjure panel in Fusion)
  3. Click the Connect or Settings button
  4. Paste your API key when prompted
  5. Click Save or Connect

For advanced configuration options, see the Configuration Guide.

Updating the Adapter

We regularly release updates with new features and bug fixes. To update your adapter:

Automatic Updates

The adapter will notify you when a new version is available. Simply:

  1. Click the update notification in your CAD software
  2. Follow the prompts to download and install the update
  3. Restart your CAD software when prompted

Manual Updates

To manually update:

  1. Download the latest version from Downloads
  2. Close your CAD software completely
  3. Replace the existing adapter files with the new ones
  4. Restart your CAD software

Troubleshooting

Adapter not appearing

  • Verify files are in the correct directory (check paths above)
  • Restart your CAD software completely (close all windows)
  • Check file permissions (files should be readable)
  • For FreeCAD: Check the Python console for error messages

Installation script fails

  • Try manual installation instead
  • Check internet connection
  • Verify you have write permissions to the Mod directory
  • On Linux/macOS: Try with sudo if needed

Connection issues

  • Verify your API key is correct
  • Check firewall settings (allow outbound HTTPS on port 443)
  • Ensure you have an active internet connection
  • Try disconnecting and reconnecting

Still having issues? Report a bug or get help in our Discord community.

Next Steps