Torrify

AI-assisted desktop app for parametric 3D CAD

Build 3D models with OpenSCAD or build123d, with an editor, AI assistant, and 3D preview in one app.

What Torrify Is

Torrify helps you design parametric 3D models from code, with AI assistance when you want it.

• Works with OpenSCAD (recommended default) and build123d (Python backend)
• Includes code editor, chat assistant, and 3D preview
• Lets you save and reload project state with .torrify files
• Runs as a desktop app (Windows, macOS, Linux)

Who This Is For

• Makers and hobbyists learning CAD scripting
• Developers who want faster model iteration
• Teams prototyping scripted geometry workflows

No advanced setup is required for basic usage.

What You Need Before You Start

• A desktop computer (Windows, macOS, or Linux)
• Torrify app installer from GitHub Releases
• OpenSCAD installed on your system
• Optional: an AI provider account/key (Gemini or OpenRouter), or local Ollama

Quick Start (Non-Technical)

1. Download and install Torrify

Get the latest release from GitHub Releases.

• Windows: install the .exe
• macOS: open the .dmg and drag to Applications
• Linux: mark the .AppImage as executable, then run it

2. Install OpenSCAD (required)

Download OpenSCAD from https://openscad.org/downloads.html.

3. Open Torrify and configure Settings

In Settings:

• Set OpenSCAD Path to your OpenSCAD executable
• (Optional) Set an AI provider (Gemini, OpenRouter, or Ollama)
• Add API key if your chosen provider requires one
• Your settings are saved locally on your machine

4. Test with your first model

Paste this into the editor and render:

cube([20, 20, 20]);

If the 3D preview updates, your setup is working.

Optional Setup

Use build123d (Python backend)

If you prefer Python-based CAD:

pip install build123d

Then set Python Path in Settings and switch backend.

Use AI fully local with Ollama

If you do not want cloud AI providers, use Ollama locally. See:

• docs/features/LLM_INTEGRATION.md

If You Get Stuck

• Installation help: docs/getting-started/installation.md
• Step-by-step first run: docs/getting-started/QUICKSTART.md
• Common errors: docs/getting-started/TROUBLESHOOTING.md

Build From Source (Developers)

git clone https://github.com/caseyhartnett/torrify.git
cd torrify
npm install
npm run electron:dev

Useful commands:

• npm run lint run ESLint
• npm test run test suite
• npm run test:coverage generate coverage report
• npm run package build installer for current OS
• npm run docs:dev run docs locally

Documentation Map

Start Here

• Docs home: docs/index.md
• Getting started overview: docs/getting-started/index.md

Product Docs

• Features overview: docs/features/overview.md
• CAD backends: docs/features/CAD_BACKENDS.md
• AI integration: docs/features/LLM_INTEGRATION.md
• Settings: docs/features/SETTINGS.md
• FAQ: docs/reference/faq.md

Technical Docs

• Developer docs: docs/developer/index.md
• Architecture: docs/architecture/index.md
• Security docs: docs/security/index.md

Community and Support

• Contributing guide: CONTRIBUTING.md
• Code of conduct: CODE_OF_CONDUCT.md
• Security policy: SECURITY.md
• Issues: https://github.com/caseyhartnett/torrify/issues
• Contact: hello@torrify.org

License

Torrify is licensed under the GNU General Public License v3.0.