Configuration

Configure Conjure settings, preferences, and advanced options for optimal performance.

Overview

Conjure offers various configuration options to customize behavior, performance, and integration with your CAD software. This guide covers all available settings and how to configure them.

Accessing Settings

FreeCAD

  1. Switch to the Conjure workbench
  2. Click Conjure → Preferences in the menu
  3. Or click the Settings button in the Conjure panel

Fusion 360

  1. Open the Conjure panel
  2. Click the Settings (gear) icon
  3. Modify settings in the dialog that appears

API Configuration

API Key

Your API key authenticates requests to the Conjure server.

  • Setting: api_key
  • Format: String (typically starts with cj_)
  • Security: Stored securely in your system keychain (not in plain text)

Server URL

The Conjure server endpoint. Only change this if using a self-hosted instance.

  • Setting: server_url
  • Default: https://api.conjure.lautrek.com
  • Format: Full URL including protocol (https://)

Request Timeout

Maximum time to wait for server responses.

  • Setting: timeout
  • Default: 30 seconds
  • Range: 5-120 seconds
  • Note: Complex operations may need longer timeouts

Performance Settings

Auto-Recompute

Automatically recompute the document after each operation.

  • Setting: auto_recompute
  • Default: Enabled
  • When to disable: Working with complex models where recompute is slow
If disabled, manually recompute with F5 or Edit → Refresh

Operation History

Number of operations to keep in the undo history.

  • Setting: history_limit
  • Default: 50 operations
  • Range: 10-500 operations
  • Note: Higher values use more memory

Batch Operations

Allow batching multiple operations into a single transaction.

  • Setting: enable_batching
  • Default: Enabled
  • Benefit: Faster execution for sequences of operations

Display Settings

Show Operation Feedback

Display visual feedback when operations complete.

  • Setting: show_feedback
  • Default: Enabled
  • Options: Toast notifications, status bar, or disabled

Highlight Created Objects

Automatically select and highlight newly created objects.

  • Setting: highlight_new
  • Default: Enabled
  • Duration: 3 seconds (configurable)

Viewport Auto-Fit

Automatically adjust viewport to show new objects.

  • Setting: auto_fit_view
  • Default: Disabled
  • Note: Can be disorienting with frequent operations

Units and Precision

Default Units

The unit system used when no unit is specified.

  • Setting: default_units
  • Default: Millimeters (mm)
  • Options: mm, cm, m, in, ft
  • Note: You can always specify units explicitly (e.g., "50mm" or "2 inches")

Decimal Precision

Number of decimal places for dimension display.

  • Setting: precision
  • Default: 2 decimal places
  • Range: 0-6 decimal places

Tolerance

Geometric tolerance for operations like face selection.

  • Setting: tolerance
  • Default: 0.01mm
  • Note: Smaller values are more precise but may fail on complex geometry

AI Integration

Enable Context Hints

Provide the AI with context about your current document state.

  • Setting: enable_hints
  • Default: Enabled
  • Benefit: More accurate AI responses based on existing geometry
  • Privacy: Only sends object counts and types, not actual geometry

Operation Confirmation

Require confirmation before executing operations.

  • Setting: require_confirmation
  • Default: Disabled
  • Options: Never, Destructive only, or Always
  • Note: "Destructive" includes delete, cut, and boolean subtract operations

Advanced Settings

Debug Mode

Enable verbose logging for troubleshooting.

  • Setting: debug_mode
  • Default: Disabled
  • Output: FreeCAD Python console or Fusion 360 debug panel
  • Note: May impact performance

Custom Headers

Add custom HTTP headers to API requests (advanced users only).

  • Setting: custom_headers
  • Format: JSON object (e.g., {"X-Custom": "value"})
  • Use case: Corporate proxy authentication

Telemetry

Share anonymous usage data to help improve Conjure.

  • Setting: telemetry_enabled
  • Default: Enabled
  • Data collected: Operation types, error rates, adapter version
  • Privacy: No geometry or personal data is sent

Configuration File

Settings are stored in a configuration file that you can edit directly if needed:

File Locations

  • Linux: ~/.config/conjure/config.json
  • macOS: ~/Library/Application Support/Conjure/config.json
  • Windows: %APPDATA%\Conjure\config.json

Example Configuration

{
  "api_key": "cj_xxxxxxxxxxxx",
  "server_url": "https://api.conjure.lautrek.com",
  "timeout": 30,
  "auto_recompute": true,
  "default_units": "mm",
  "precision": 2,
  "show_feedback": true,
  "highlight_new": true,
  "enable_hints": true,
  "debug_mode": false
}
Warning: Manually editing the config file requires restarting your CAD software. Always validate JSON syntax to avoid errors.

Resetting Settings

To reset all settings to defaults:

  1. Close your CAD software
  2. Delete or rename the configuration file (see locations above)
  3. Restart your CAD software
  4. Reconnect with your API key

Alternatively, use the Reset to Defaults button in the settings panel.

Next Steps