AiSpire
AiSpire is an AI-powered interface for Vectric Aspire and V-Carve CAD/CAM software, enhancing design and machining capabilities. The project features Lua and Python components for vector manipulation and toolpath optimization, offering an interactive UI for users.
.oo o .oPYo. o
.P 8 8
.P 8 o8 `Yooo. .oPYo. o8 oPYo. .oPYo.
oPooo8 8 `8 8 8 8 8 `' 8oooo8
.P 8 8 8 8 8 8 8 8.
.P 8 8 `YooP' 8YooP' 8 8 `Yooo'
..:::::..:..:.....:8 ....::....:::::.....:
:::::::::::::::::::8 :::::::::::::::::::::
:::::::::::::::::::..:::::::::::::::::::::
AiSpire
AiSpire is an intelligent interface for Vectric Aspire and V-Carve CAD/CAM software that enables AI-powered design and machining capabilities.
Overview
AiSpire consists of two primary components:
- Lua Gadget - A plugin for Vectric Aspire/V-Carve that runs inside the CAD/CAM environment
- Python MCP Server - A server implementing the Model Context Protocol for LLM integration
┌─────────────┐ ┌─────────────┐ ┌─────────┐
│ │ │ │ │ │
│ LLMs │◄─────────► │ Python MCP │◄─────────► │ Lua │
│ │ (MCP) │ Server │ (Socket) │ Gadget │
│ │ │ │ │ │
└─────────────┘ └─────────────┘ └─────────┘
│
│
▼
┌─────────────┐
│ Vectric │
│ Aspire/ │
│ V-Carve │
└─────────────┘
Features
- Execute arbitrary Lua code inside Vectric software
- Create and manipulate vector paths programmatically
- Import and modify 3D models
- Draw vector shapes and text
- Optimize vector nesting for material utilization
- Generate and calculate toolpaths for CNC machining
- Interactive UI with log viewing and command history
- Utilize advanced Vectric SDK capabilities:
- Matrix transformations for precise object manipulation
- Specialized job types (two-sided, rotary)
- Advanced toolpath strategies (V-carving, fluting, prism carving)
- Tool database integration
- Custom UI elements (HTML dialogs, progress bars)
- External toolpath generation and import/export
Project Status
AiSpire is currently in active development. Key components have been implemented:
- Lua Socket Server: Basic socket server with command processing pipeline
- Command Processing: Framework for executing Lua code and SDK functions
- UI Manager: Interactive user interface with log viewer and command history
- Helper Functions: Comprehensive library for common operations
- Python MCP Server: Basic MCP protocol implementation with socket client
UI Features
The AiSpire Gadget includes a comprehensive user interface:
- Log Viewer: Real-time display of system messages with color-coded severity levels
- Command History: View and replay past commands with success/failure indicators
- History Management: Save and load command histories for future reference
- Connection Status: Visual indicators showing connection state and activity
- Disconnect Controls: Safely disconnect with confirmation dialog
The UI is accessible in two ways:
- Primary gadget action starts the server with UI
- Secondary action ("Show AiSpire Control Panel") opens just the UI without restarting the server
Directory Structure
lua_gadget/- Lua plugin for Vectric softwareserver.lua- Socket server implementationui_manager.lua- UI implementation for the gadgetjson.lua- JSON parsing implementationhelpers/- Helper functions for common operations
python_mcp_server/- Python implementation of MCP servertests/- Test files for both componentsdocs/- Project documentationvectric_sdk/- Contains detailed Vectric SDK reference documentation
llm_brain/- AI development guidelines and project memory
Getting Started
Coming soon - Installation and usage instructions will be provided when the first functional version is available.
Building and Testing
The project includes a Makefile with various commands for building and testing:
# Install development dependencies
make install-dev-deps
# Run all tests
make test
# Run specific test suites
make test-all-lua # Run all Lua tests
make test-all-python # Run all Python tests
make test-e2e # Run end-to-end tests
# More granular test options
make test-lua # Run Lua tests in tests/lua_tests/
make test-lua-helpers # Run Lua helper tests
make test-python-core # Run Python core tests
make test-python-mcp # Run Python MCP server tests
make test-python-tests # Run tests in tests/python_tests
# Create Vectric gadget bundle
make bundle
# Show all available commands
make help
Requirements
- Vectric Aspire or V-Carve software
- Lua 5.3+ with LuaSocket library
- Python 3.8+ with required packages (see requirements.txt once available)
- Access to an LLM supporting the Model Context Protocol
SDK Reference
The project includes a comprehensive Vectric SDK reference (located in docs/vectric_sdk/Vectric.lua) that documents the available functions for interacting with Vectric Aspire/V-Carve. This reference covers:
- Job creation and management
- Vector and geometry operations
- Toolpath generation with various strategies
- Tool database access
- User interface elements
- 3D component manipulation (Aspire only)
- System information and registry access
Planned Enhancements
Based on the detailed SDK reference, we plan to implement:
- Advanced Geometric Operations: Matrix-based transformations, complex path creation, and polar coordinate functions
- Specialized Job Management: Support for two-sided and rotary jobs
- Comprehensive Toolpath Strategies: Profile, pocket, V-carving, fluting, prism carving, 3D roughing and finishing
- Tool Database Integration: Access system tool database, create custom tools
- UI Integration: Custom dialogs, progress bars, file selection interfaces
- System Integration: Application detection, file location access, registry settings
- External Toolpath Support: Generate, import, and export custom toolpaths
License
License information to be determined
Contact
Contact information to be provided