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
- Switch to the Conjure workbench
- Click
Conjure → Preferencesin the menu - Or click the Settings button in the Conjure panel
Fusion 360
- Open the Conjure panel
- Click the Settings (gear) icon
- 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
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
}
Resetting Settings
To reset all settings to defaults:
- Close your CAD software
- Delete or rename the configuration file (see locations above)
- Restart your CAD software
- Reconnect with your API key
Alternatively, use the Reset to Defaults button in the settings panel.