Shilpakara: AI-Powered Rhino 3D Design Bridge

Overview

Shilpakara (शिल्पकार) is a local MCP (Model-Controller-Proxy) server that bridges OpenRouter AI models with Rhino 3D design software. The name "Shilpakara" comes from Sanskrit, meaning "craftsman" or "sculptor," reflecting the system's purpose of assisting in 3D design and modeling through AI.

This bridge allows users to design in Rhino 3D by simply providing natural language prompts to AI models, which then translate these prompts into executable Rhino commands and design operations.

Features

• Dual Mode Operation:

  • Agent Mode: Generates executable Rhino 3D commands based on design prompts
  • Chat Mode: Provides design advice and explanations without generating commands

• OpenRouter Integration:

  • Choose from all available OpenRouter models (free and premium)
  • Leverage state-of-the-art AI models for design assistance

• Reference Image Support:

  • Upload reference images for visual design inspiration
  • AI analyzes images to create 3D designs based on visual references

• Context-Aware Design:

  • Understands selected objects and their properties
  • Analyzes scene composition and spatial relationships
  • Tracks command history and conversation context

• Local Processing: Run as a local server for faster response times and privacy

• Bidirectional Communication: Send design context to AI and receive design instructions

• Design History: Track and manage the history of AI-assisted design operations

Architecture

Shilpakara consists of three main components:

1. MCP Server: The central component that manages communication between Rhino and AI models
2. Rhino Integration: Plugins and scripts that connect Rhino 3D to the MCP server
3. OpenRouter Client: Components that handle communication with OpenRouter AI models

Getting Started

Prerequisites

• Rhino 3D (Version 7 or later)
• Python 3.8+
• OpenRouter API key

Installation

1. Clone this repository
2. Install required dependencies
3. Configure your OpenRouter API key
4. Install the Rhino plugin
5. Start the MCP server

Usage

1. Open Rhino 3D
2. Start the Shilpakara server
3. Use the Shilpakara panel in Rhino:
   • Select a mode (Agent or Chat)
   • Choose an AI model from the dropdown
   • Optionally upload a reference image
   • Enter your design prompt
   • Review the AI response
   • Execute generated commands (in Agent mode)

See USAGE.md for a comprehensive guide on how to use Shilpakara.

Development

Shilpakara is under active development. Contributions are welcome!

License

MIT License