Installation

FORGE Studio is an Electron desktop application. Pre-built binaries are distributed as a macOS .dmg and Linux .AppImage/.deb. For development, build from source.

System Requirements

Platform	Minimum
macOS	13 Ventura (Apple Silicon or Intel)
Linux	Ubuntu 22.04+ (x86_64)
Node.js	20.x (for building from source)
RAM	8 GB (16 GB+ recommended for large datasets)

Optional Backends

FORGE Studio auto-detects these at startup — install only what you need:

Backend	Minimum Version
MATLAB	R2020a
Python	3.10
Julia	1.9
CUDA	11.8 (Linux, for FORGE GPU binaries)

Metal is used automatically on Apple Silicon — no additional GPU setup needed.

---

Installing from a Pre-Built Binary

macOS

1. Download FORGE-Studio-x.y.z.dmg from the releases page.
2. Open the DMG and drag FORGE Studio to /Applications.
3. On first launch, right-click → Open to bypass Gatekeeper (first run only).

Linux

AppImage:

chmod +x FORGE-Studio-x.y.z.AppImage
./FORGE-Studio-x.y.z.AppImage

Debian/Ubuntu package:

sudo dpkg -i forge-studio_x.y.z_amd64.deb
forge-studio

---

Building from Source

# Clone the repository
git clone https://github.com/your-org/forge-studio.git
cd forge-studio

# Install Node.js dependencies
npm install

# Start in development mode (hot reload)
npm run dev

# Or build a production binary
npm run dist

Python venv (for development testing)

The project includes a pyproject.toml managed with uv:

# Install uv if needed
curl -Lsf https://astral.sh/uv/install.sh | sh

# Create venv and install dependencies
uv sync

# The venv is at .venv/
.venv/bin/python3 --version

---

Updating

When a new version is available, FORGE Studio will show an update badge in the title bar. Go to Settings → About → Check for Updates to download and install automatically.

---

Next Steps

• First Run → — complete the setup wizard
• Quick Start → — run your first reconstruction