# RoGenie Bridge: Roblox AI generation and Blender

> The optional Windows app that lets RoGenie use Roblox's own AI generators in Studio and work in your Blender. Install it, pair it, keep it running, and what it can and cannot do.

The **RoGenie Bridge** is a small, optional Windows app. It lets RoGenie use Roblox Studio's built-in AI generators on your PC, and work in your own Blender when it's open. RoGenie's website can't reach either on its own. Everything else in RoGenie works without it.

## What it unlocks

With the Bridge running and paired, RoGenie can:

- generate a real **textured 3D mesh** from a description,
- generate **PBR materials** (MaterialVariants) and apply them to parts,
- generate **models and procedural objects** with AI,
- **upload images** to Roblox as textures and decals for your place,
- work in **Blender** on the same PC, and send models, rigs and animations into Studio. See [Blender](https://rogenie.ai/docs/blender).

The first four are the tools in the *AI Generation* group of [Tool access](https://rogenie.ai/docs/tool-access), and Blender is the *Blender* group. Without the Bridge they are unavailable, and RoGenie builds from primitive parts or the Toolbox instead. See [AI meshes, materials and image uploads](https://rogenie.ai/docs/ai-generation) for how to ask for them.

## Requirements

- **Windows.** The Bridge runs on Windows only. It has to run on the same PC as Roblox Studio, so if you use Studio on a Mac, AI generation and Blender are not available; everything else still works.
- **Roblox Studio** installed and opened at least once, with a place open while you generate.
- Studio's built-in **MCP server** turned on. The Bridge turns it on for you (switch off **Automatically turn on Studio's MCP server** in its window if you'd rather do it yourself). A Studio that was already open reads the setting only when it starts, so the window offers to restart it. To do it by hand: in Studio open the **Assistant**, then **⋯ › Settings › MCP Servers**, and turn on **Enable Studio as MCP server**.
- **For Blender:** Blender 5.2 or newer, open on the same PC. The Bridge installs the add-on RoGenie needs. See [Blender](https://rogenie.ai/docs/blender#what-you-need).

## Install it

In the app, click the **Studio** button in the top bar and choose **Download / Connect Bridge** (or **Download RoGenie Bridge** in the *Pair Roblox Studio* window). The *Get the RoGenie Bridge* window offers two editions:

| Edition | Who it is for | What you download |
|---|---|---|
| **Easy install** (recommended) | Almost everyone | `RoGenie Bridge Setup.exe`. One file that installs itself for your Windows user, opens, starts with Windows and updates itself. Nothing to unzip. It gets a Start menu entry and can be uninstalled from **Windows Settings › Apps**. |
| **Open source** (developers only) | People who want to read the code first | `Get RoGenie Bridge.bat`. A script that fetches the Bridge as readable Python into a folder next to it, downloads an official portable Python from python.org (about 10 MB, checked against a fixed SHA-256), and starts it. No admin rights needed. Later, start it with `Start RoGenie Bridge.bat`. It updates itself too. |

Run the file from your Downloads folder. Windows may ask you to confirm before running a downloaded file (see [Why does Windows or Edge warn about the installer?](https://rogenie.ai/docs/bridge#windows-warning)). If your antivirus blocks or removes it, see [Your antivirus blocks the Bridge](https://rogenie.ai/docs/troubleshooting-bridge#antivirus).

## Check your download
You can check that the installer you downloaded is exactly the one RoGenie published, by its SHA-256:
The current SHA-256 of `RoGenie Bridge Setup.exe`, with its version, is published at https://rogenie.ai/api/bridge/latest (`exe.sha256` and `exe.version`).
In PowerShell, in your Downloads folder, run:

```powershell
Get-FileHash .\"RoGenie Bridge Setup.exe" -Algorithm SHA256
```

The **Hash** it prints must match the SHA-256 above (capital or small letters don't matter). If it doesn't, delete the file and download it again from the app. The *Get the RoGenie Bridge* window shows the same SHA-256 on its **Easy install** card, under the steps and above the **Download Easy install** button.

## Why does Windows or Edge warn about the installer?
The installer is not code-signed yet, so Microsoft SmartScreen (in Windows and in Edge) has no reputation for it. It may say *Windows protected your PC*, or that the file *isn't commonly downloaded*. That is not a sign that anything is wrong with it.

1. [Check your download](https://rogenie.ai/docs/bridge#verify) by its SHA-256.
2. **Edge:** open the download's **⋯** menu, choose **Keep**, then **Show more › Keep anyway**.
3. **Windows:** when *Windows protected your PC* appears, click **More info**, then **Run anyway**.

## Pair it

1. When the Bridge opens for the first time, it shows an **8-digit code** (a new code every 5 minutes until one is used).
2. Click **Open rogenie.ai to pair** in the Bridge window, or open the *Pair Roblox Studio* window in the app yourself.
3. Enter the code and click **Pair**.

The Bridge remembers your account after that. Its window looks like the RoGenie website and wears your theme and genie once paired.

## Keep it running

- **Close or hide the window whenever you like.** The Bridge keeps running in the system tray, near the clock. Left-click its icon to reopen the window; right-click for **Open**, **Start with Windows** and **Stop**.
- **Start with Windows.** Turn this on in the window or the tray menu so the Bridge starts quietly every time you sign in to Windows, and AI generation just works.
- **Idle cost.** With the window closed, the Bridge uses almost nothing.
- **Status in the app.** If the Bridge is not connected, the Studio menu says *Bridge offline* and the AI Generation tools show as unavailable. The [Tool access](https://rogenie.ai/docs/tool-access) panel says when the Bridge is connected.

## Your Discord status

With the Discord app open on your PC, the Bridge shows RoGenie at work on your Discord profile: **Building in Roblox Studio**, what RoGenie is doing right now (thinking, writing scripts, building, playtesting, reviewing, or waiting for you) and for how long. A **Try RoGenie** button on it carries your [referral link](https://rogenie.ai/docs/referrals), so a friend who signs up from it counts as your referral.

- **Between runs,** while Roblox Studio is open, it says *Roblox Studio open* and *RoGenie ready* for half an hour. With Studio closed it shows nothing.
- **Never your chats.** RoGenie tells the Bridge only which step a run is on and when it started; the words on your profile are the Bridge's own.
- **Your place's name** is shown only if you switch on **Show the place name** in the Bridge window.
- **Turn it off** with **Show what I'm building on Discord** in the Bridge window. It's on until you do, and an update keeps your choice.
- **Discord opened after the Bridge?** It finds Discord by itself within seconds. The window says whether it's connected.

## Updates

Both editions update themselves:

- Updates come only from `rogenie.ai` over HTTPS, and the Bridge installs only updates signed with RoGenie's offline release key. Every downloaded file is checked against the signed list of hashes; anything that does not match is thrown away and nothing changes.
- An update never happens in the middle of a generation or while a pairing code is on screen, and the Bridge never goes back to an older version.
- If a new version fails to start, the previous one is put back and starts again.

To update by hand, download the Bridge again from the app and run it.

## Is it safe?

- The Bridge forwards only Roblox's **generation tools** (generate a mesh, a material or a procedural model, upload an image) and, when Blender is open, a **reviewed list of Blender tools**. Blender's raw-Python tools are off, and tools that open, save, export or render files at a path RoGenie picks are blocked. The Bridge exports and renders only into its own folder. It does not read your other files, and changes nothing in your place beyond what you ask RoGenie to make.
- It connects **out** to `rogenie.ai` over an encrypted connection. It does not open your computer to the internet; its window is served on `127.0.0.1` (your machine only) and only answers requests that carry a secret made fresh each time it starts.
- Besides Roblox Studio, the only other programs it talks to are **Blender**, through its add-on on your PC and only while Blender is open, and the **Discord app**, over Discord's own local connection and only to set or clear your Discord status.
- The open-source edition is plain, readable Python that uses only Python's standard library, so you can check all of this yourself.
- When Blender is open, the Bridge also installs the pinned **blenderwright** Blender add-on (version 3.1.0, its download checked against a fixed SHA-256) and the matching blenderwright helper, so RoGenie can talk to Blender.
- That helper runs through **uv**, Astral's Python tool runner. If your PC has no usable uv (none, or one older than 0.13.4, which has a security fix), the Bridge 2.4.2 and newer sets up its own once Blender is on your PC (installed or open), or when you press **Install uv for me**: one pinned uv release from `github.com/astral-sh/uv`, checked against a fixed SHA-256 before it is unpacked, into `%LOCALAPPDATA%\RoGenie\tools\uv`. It doesn't change your PATH or anything else in Windows, a uv you installed yourself still comes first, and an older Bridge's uv in that folder is removed once the new one works.

## Uninstall

- **Easy install:** Windows **Settings › Apps**, find **RoGenie Bridge**, and uninstall.
- **Open source:** stop it from the tray menu, then delete its folder.

After uninstalling, RoGenie cannot make AI meshes or materials, upload images, or use Blender until you install the Bridge again.

## Problems?

See [Bridge won't connect](https://rogenie.ai/docs/troubleshooting-bridge). The Bridge's log file is at `%LOCALAPPDATA%\RoGenie\bridge.log`.