Skip to main content
Beeble Studio currently supports Windows and Rocky Linux only, and requires an NVIDIA GPU.

​
Installation Guide

​
1. Download & Install

Download Beeble Studio Installer

Get the installer for Windows or Rocky Linux

​
2. Launch & Sign In

Launch the app and sign in. You’ll need an active Beeble Studio plan (7-day free trial available).

​
3. Download Models

Download required engine and model files. You’re now ready for local GPU processing! 🎉

​
Hardware Requirements

ComponentMinimumRecommended
OSWindows 10/11 ¹ ²
Rocky Linux 8 & 9		Windows 10/11 ¹
Rocky Linux 8 & 9
CPUIntel or AMD (AVX support, 2020 or newer)Intel or AMD (AVX support, 2020 or newer)
NVIDIA GPUAmpere architecture or newer (e.g., RTX 30-series, RTX A6000)Ada Lovelace architecture or newer (e.g., RTX 50-series, RTX 6000 Ada)
GPU Memory (VRAM)12 GB or more ³24 GB or more
System Memory (RAM)16GB32GB
Storage20GB free space100GB free space
InternetRequired for installation, authentication, and updatesRequired for installation, authentication, and updates
Important Notes:¹ Mac is not currently supported.² Windows 10 is supported but may reach end-of-life before 2026 — Windows 11 is recommended.³ GPUs with less than 12 GB VRAM may run but at unusable speeds.

​
Firewall & Network Configuration

If you’re deploying Beeble Studio in a corporate or restricted network environment, ensure the following network requirements are met: Protocol & Port:
  • HTTPS (TCP 443) — All communication uses secure HTTPS over port 443
Required Domains:
DomainPurpose
app.beeble.aiMain application services
api.beeble.aiAuthentication and API services (will be deprecated on Mar 1st.)
platform.modal.beeble.aiAuthentication and API services
release.beeble.aiSoftware updates and AI model downloads
cdn.beeble.aiPublic assets and static content
beeble-release.s3.amazonaws.comSoftware release storage
clerk.beeble.aiUser authentication
accounts.beeble.aiUser authentication
challenges.cloudflare.comBot protection challenges during sign-in
For enterprise deployments, add these domains to your firewall allowlist and ensure in/outbound HTTPS traffic on TCP port 443 is permitted.

​
Using a Proxy Server

If your organization routes outbound traffic through an HTTP/HTTPS proxy — including TLS-inspecting corporate proxies — Beeble Studio requires the configuration below. Some components do not automatically follow the operating system’s proxy settings, so each step is required for full functionality.
1

Launch the app with the proxy server flag

Start Beeble Studio with the --proxy-server flag pointing at your proxy. This routes the application’s traffic and update checks through it.
beeblestudio --proxy-server="http://proxy.example.com:8080"
On Windows, add the flag to the end of the Target field in the Beeble Studio shortcut’s properties. On Rocky Linux, launch the app from a terminal with the flag.
2

Set the proxy environment variables

The local engine downloader and processing engine read the following environment variables. Set them in the environment before launching the app:
HTTPS_PROXY="http://proxy.example.com:8080"
HTTP_PROXY="http://proxy.example.com:8080"
REQUESTS_CA_BUNDLE="/path/to/your-proxy-certificate.pem"
REQUESTS_CA_BUNDLE must point to your proxy’s CA certificate. The certificate must be PEM-encoded — a text file that begins with -----BEGIN CERTIFICATE-----. If your certificate is in another format (for example, binary DER, .p7b, or .pfx), or you are unsure where to find it, ask your IT administrator for a PEM-formatted copy.
3

Trust the proxy certificate in Chrome

When you sign in, Beeble Studio opens the login page in your Chrome browser. If your proxy inspects HTTPS traffic, import your proxy’s certificate so Chrome trusts it:Chrome → Settings → Privacy and security → Security → Manage certificates → Custom → Installed by you → Trusted Certificates → Import, then select your proxy certificate.
Replace http://proxy.example.com:8080 with your organization’s proxy address, and set REQUESTS_CA_BUNDLE to the path of your PEM-encoded proxy certificate. Your IT or network administrator can provide both.

​
Performance Benchmarks

Processing time per frame for VFX pass generation (PBR with alpha and depth) varies by GPU and resolution. See the benchmark below for reference.
GPU Model2K4K4K (4K Max Mode)
L40S1.9s2.9s6.6s
A60003.0s4.0s12.2s
RTX 5070 Ti2.0s3.0s8.0s
RTX 40902.7s3.7s11.6s
4K Max Mode processes high-resolution footage at its native resolution (up to 4K). \ Requires at least 16 GB of GPU memory.