⛮ The Open Source Text to CAD Web App ⛮

---

✨ Features

• 🤖 AI-Powered Generation - Transform natural language and images into 3D models
• 🎛️ Parametric Controls - Interactive sliders for instant dimension adjustments
• 📦 Multiple Export Formats - Export as .STL or .SCAD files
• 🌐 Browser-Based - Runs entirely in your browser using WebAssembly
• 📚 Library Support - Includes BOSL, BOSL2, and MCAD libraries

🎯 Key Capabilities

Feature	Description
Natural Language Input	Describe your 3D model in plain English
Image References	Upload images to guide model generation
Real-time Preview	See your model update instantly with Three.js
Parameter Extraction	Automatically identifies adjustable dimensions
Smart Updates	Efficient parameter changes without AI re-generation
Custom Fonts	Built-in Geist font support for text in models

📸 Demo

🎬 Try it live: https://adam.new/cadam

📺 Screenshots

More screenshots

🚀 Quick Start

# Clone the repository
git clone https://github.com/Adam-CAD/CADAM.git
cd CADAM

# Install dependencies
npm install

# Start Supabase (Requires Docker Desktop)
npx supabase start
npx supabase functions serve --no-verify-jwt

# Start the development server
npm run dev

Note: Ensure Docker Desktop is installed and running before executing npx supabase start. Supabase CLI requires Docker to run local services.

📋 Prerequisites

• Node.js and npm (v18+)
• Docker Desktop - Required for running Supabase locally (Supabase CLI uses Docker containers)
• ngrok (for local webhook development) - Optional, only needed for image URLs to external AI services

🔧 Setting Up Environment Variables

1. Frontend Environment:

• Copy .env.local.template to .env.local
• Update all required keys in .env.local:

  VITE_SUPABASE_ANON_KEY="<Test Anon Key>"
  VITE_SUPABASE_URL='http://127.0.0.1:54321'
  

2. Supabase Functions Environment:

• Copy supabase/functions/.env.template to supabase/functions/.env

• Update all required keys in supabase/functions/.env, including:

  OPENROUTER_API_KEY="<OpenRouter API Key>"
  ENVIRONMENT="local"
  NGROK_URL="<NGROK URL>" # Your ngrok tunnel URL, e.g., https://xxxx-xx-xx-xxx-xx.ngrok.io
  

  About OPENROUTER_API_KEY:

  • This is a unified API key for accessing multiple AI providers through OpenRouter
  • Used for all cloud-based models: Google Gemini, Anthropic Claude, and OpenAI GPT
  • Note: LM Studio models (local) don't require this key

  Optional for LM Studio:

  LMSTUDIO_URL="http://host.docker.internal:1234/v1/chat/completions"  # Only needed if default doesn't work
  

🌐 Setting Up ngrok for Local Development

CADAM uses ngrok to send image URLs to external AI services (for Anthropic/OpenRouter to access Supabase storage URLs):

1. Install ngrok if you haven't already:

   npm install -g ngrok
   # or
   brew install ngrok

2. Start an ngrok tunnel pointing to your Supabase instance:

   ngrok http 54321

3. Copy the generated ngrok URL (e.g., https://xxxx-xx-xx-xxx-xx.ngrok.io) and add it to your supabase/functions/.env file:

   NGROK_URL="https://xxxx-xx-xx-xxx-xx.ngrok.io"
   

4. Ensure ENVIRONMENT="local" is set in the same file.

Note: LM Studio uses host.docker.internal to connect directly to your host machine - no ngrok needed for LM Studio!

💻 Development Workflow

Install Dependencies

npm i

Start Supabase Services

Important: Make sure Docker Desktop is running before starting Supabase services.

npx supabase start
npx supabase functions serve --no-verify-jwt

🛠️ Built With

• Frontend: React 18 + TypeScript + Vite
• 3D Rendering: Three.js + React Three Fiber
• CAD Engine: OpenSCAD WebAssembly
• Backend: Supabase (PostgreSQL + Edge Functions)
• AI: OpenRouter API (Google Gemini, Anthropic Claude, OpenAI GPT) + LM Studio (local models)
• Styling: Tailwind CSS + shadcn/ui
• Libraries: BOSL, BOSL2, MCAD

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

🙏 Credits

This app wouldn't be possible without the work of:

• OpenSCAD
• openscad-wasm
• openscad-playground
• openscad-web-gui
• dingcad

📄 License

This distribution is licensed under the GNU General Public License v3.0 (GPLv3). See LICENSE.

Components and attributions:

• Portions of this project are derived from openscad-web-gui (GPLv3).
• This distribution includes unmodified binaries from OpenSCAD WASM under GPL v2 or later; distributed here under GPLv3 as part of the combined work. See src/vendor/openscad-wasm/SOURCE-OFFER.txt.

---

⭐ If you find CADAM useful, please consider giving it a star!

Made with 💙 for the 3D printing and CAD community