kinetic-forge-studio

[](https://github.com/Abhishekv87bit/kinetic-forge-studio/actions/workflows/ci.yml) [](LICENSE) [](https://www.python.org/downloads/) [](https://www.typescriptlang.org/) [](https://react.dev/) [](https://fastapi.tiangolo.com/)

AI-powered kinetic sculpture design studio. Design, simulate, and export mechanical art with Claude, Gemini, CadQuery, and Three.js.

graph LR
    A[React + Three.js<br/>Frontend] -->|REST API| B[FastAPI<br/>Backend]
    B --> C[CadQuery<br/>Engine]
    B --> D[Claude API<br/>AI Chat]
    B --> E[Gemini API<br/>Photo Analysis]
    C --> F[STEP / STL<br/>Export]
    D --> C
    style A fill:#61DAFB,color:#000
    style B fill:#009688,color:#fff
    style C fill:#FF6B6B,color:#fff
    style D fill:#7C3AED,color:#fff
    style E fill:#4285F4,color:#fff
    style F fill:#96CEB4,color:#000

Kinetic Forge Studio is a full-stack web application that lets you design kinetic sculptures through natural language conversation with AI. Describe what you want, and the AI generates parametric 3D models using CadQuery, renders them in a Three.js viewport, and exports fabrication-ready STEP files.

Key features:

• AI Chat Interface — Describe sculptures in plain English, get parametric 3D models
• Dual AI Engines — Claude for design reasoning, Gemini for photo-to-model analysis
• Real-time 3D Viewport — Three.js/React Three Fiber with orbit controls
• CadQuery Engine — Python-based parametric CAD with VLAD validation
• Export Pipeline — STEP, STL, and OBJ export for fabrication