Aispire

🚀 AiSpire Intelligent Interface

AiSpire is an intelligent interface for Vectric Aspire and V-Carve CAD/CAM software, enabling AI-driven design and machining capabilities.

🚀 Quick Start

To start using AiSpire, please complete the following preparations:

1. Install Vectric Aspire or V-Carve software.
2. Configure the Lua 5.3+ environment and install the LuaSocket library.
3. Install Python 3.8+ and configure the required dependencies (see requirements.txt).
4. Obtain an LLM service that supports the MCP protocol.

✨ Features

• Arbitrary Lua code execution: Run any Lua script inside Vectric software.
• Complex geometric operations: Support advanced geometric processing such as matrix transformation and polar coordinate calculation.
• Professional machining strategies: Include various cutting methods such as contour milling, slot milling, V-milling, roughing, and finishing.
• Tool database access: Access the system tool library and support the creation of custom tools.
• Custom user interface: Provide interactive elements such as dialog boxes and progress bars.

📚 Documentation

Project Overview

AiSpire consists of two main components:

1. Lua component - A plugin that runs inside Vectric software.
2. Python MCP server - An LLM integration server that implements the Model Context Protocol (MCP).

                 ┌─────────────┐            ┌─────────────┐            ┌─────────┐
                 │             │            │             │            │         │
                 │    LLMs     │◄─────────► │ Python MCP  │◄─────────► │   Lua   │
                 │             │   (MCP)    │   Server    │  (Socket)  │         │
                 └─────┬──────┘            └─────┬──────┘            └─────┬──────┘
                        │                        │                         │
                        ▼                        ▼                         ▼
                     Vectric  software             Processor                  User interface

Project Status

Current Features

1. Basic geometric operations and path generation.
2. Execution of standard machining tasks.
3. Basic access to the tool database.
4. Simple user interface interaction.

Planned Features

1. Support for advanced matrix transformation.
2. Optimization of professional cutting strategies.
3. Implementation of complex multi-axis machining.
4. Integration of AI-assisted design functions.

Directory Structure

The project files are divided by function as follows:

.
├── lua_component/        # Lua plugin code
│   ├── server.lua       # Main server logic
│   └── utils/          # Utility functions
├── python_mcp/         # Python MCP server implementation
│   ├── mcp_core.py     # Core MCP protocol processing
│   └── handlers/       # Various request handlers
└── ui_elements/        # User interface components
    ├── dialogs/          # Dialog templates
    └── progressbars/   # Progress bar implementation

Building and Testing

The project provides various testing options:

make help              # Display all available commands
make test-lua          # Run Lua unit tests
make test-python       # Run Python core tests
make bundle           # Package and generate the Vectric plugin package

Technical Requirements

• Hardware: A modern PC supporting OpenGL 2.0 or higher.
• Software:
  • Vectric Aspire/V-Carve software.
  • Lua 5.3+ with LuaSocket.
  • Python 3.8+ with the standard library and third-party packages.
• Network: Internet connection (for LLM services).

SDK Reference

The project comes with detailed Vectric SDK documentation, covering the following aspects:

• Creation and management of work tasks.
• Vector and geometric operations.
• Strategies for generating machining paths.
• Interfaces for accessing the tool library.
• Usage of user interface components.
• Retrieval of system information.

Planned Enhancements

Based on the SDK reference, the following features are planned for future implementation:

1. Advanced geometric calculations: Matrix transformation, complex path generation, and support for polar coordinates.
2. Professional machining tasks: Multi-axis milling, five-axis machining, and optimization of high-speed cutting.
3. Intelligent tool management: Creation and management of custom tool libraries.
4. AI-assisted design: Integration of machine learning models for intelligent design suggestions.
5. System extension interfaces: Support for third-party plugin development.

📄 License

License information to be determined

Contact Information

Contact information to be provided