Adam-CAD / CADAM

CADAM is the open source text-to-CAD web application

⛮ 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
npx supabase start
npx supabase functions serve --no-verify-jwt

# Start the development server
npm run dev

📋 Prerequisites

• Node.js and npm
• Supabase CLI
• ngrok (for local webhook development)

🔧 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:

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

🌐 Setting Up ngrok for Local Development

CADAM uses ngrok to send image URLs to Anthropic:

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.

💻 Development Workflow

Install Dependencies

npm i

Start 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: Anthropic Claude API
• 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