Docs / Guides

Install Guide

Follow these steps to install AstraBlox Studio on Windows, Mac or Linux and connect it to Roblox Studio.

Need live help during setup? Join the AstraBlox Discord anytime.


1. Download AstraBlox Studio

Get the file for your computer from the latest release or the website, which picks the right one for you.

Your computer File
Windows 10 / 11 (64-bit) AstraBloxSetup.exe
Mac with Apple Silicon (M1–M4) AstraBlox-mac-arm64.dmg
Intel Mac AstraBlox-mac-x64.dmg
Linux (64-bit) AstraBlox-linux-x64.AppImage or AstraBlox-linux-x64.tar.gz

Every file's SHA-256 checksum is listed in SHA256SUMS.txt on the release page.
Windows & Web Edition are on v2.6.2; Mac & Linux builds are on v2.6.1 (picked automatically by the website and Mac script).


2. Install

Windows

  1. Double-click AstraBloxSetup.exe.
  2. If Microsoft Defender SmartScreen shows "Windows protected your PC", click More info → Run anyway. (New indie apps show this until they are code-signed.)
  3. Accept the license and click Install. AstraBlox installs into %LOCALAPPDATA%\Programs\AstraBlox and adds Desktop and Start Menu shortcuts.
  4. Click Launch AstraBlox.

Upgrading keeps all your projects, AI memory, style guides and saved keys in %USERPROFILE%\.astrablox.

Mac

Easiest (no security warning): open Terminal (Cmd+Space, type "Terminal"), paste this and press Return:

curl -fsSL https://bobkinloch5-creator.github.io/astrablox/install-mac.sh | bash

It picks the right version for your Mac (Apple Silicon or Intel), checks the download's SHA-256 checksum, installs AstraBlox into Applications and opens it.

Or use the DMG:

  1. Open the .dmg and drag AstraBlox Studio onto Applications.
  2. Open it. If macOS says "Apple could not verify AstraBlox Studio is free of malware", click Done, then: - open System Settings → Privacy & Security, scroll down and click Open Anyway next to AstraBlox Studio, then confirm with your password or Touch ID; or - paste this into Terminal and press Return: bash xattr -dr com.apple.quarantine "/Applications/AstraBlox Studio.app" You only need to do this once. (macOS shows this for apps that aren't yet notarized by Apple.) Download AstraBlox-mac-arm64.dmg for Apple Silicon (M1–M4) or AstraBlox-mac-x64.dmg for Intel Macs. Not sure? Apple menu → About This Mac: "Chip: Apple M…" means Apple Silicon, "Processor: Intel" means Intel.
  3. AstraBlox installs its Roblox Studio plugin into ~/Documents/Roblox/Plugins.

Linux

AppImage (simplest): make the file executable (chmod +x AstraBlox-linux-x64.AppImage, or right-click → Properties → Allow executing) and double-click it.

tar.gz (adds an app-menu entry):

tar xzf AstraBlox-linux-x64.tar.gz
cd AstraBlox-linux-x64
./install.sh        # installs for your user, no sudo

Then open AstraBlox Studio from your app menu, or run astrablox.

Roblox Studio has no Linux version, so run it through Vinegar. AstraBlox finds Studio's plugin folder inside Vinegar automatically.

Windows silent install (optional)

Advanced users can install or update without GUI prompts:

.\AstraBloxSetup.exe --silent --relaunch

3. Connect Your First AI Provider

When AstraBlox opens in its desktop window (http://127.0.0.1:4860), follow the First-Run Setup Guide or click the Settings gear icon (bottom left) → AI Providers:

See the full Configuration Guide for every setting, model guide, and optional creative integration.


4. Install & Enable the Roblox Studio Bridge Plugin

AstraBlox builds directly inside your open Roblox Studio place through the AstraBlox Bridge plugin:

  1. In AstraBlox, go to Settings → Roblox Plugin & Keys (or click Studio on the left sidebar) and press Install plugin (Connect / Install Bridge). - This installs AstraBloxBridge.server.lua into Roblox's plugins folder with your paired token (%LOCALAPPDATA%\Roblox\Plugins on Windows, ~/Documents/Roblox/Plugins on Mac, inside Vinegar's prefix on Linux).
  2. Restart Roblox Studio and open any place (published or local .rbxl file).
  3. In Roblox Studio, open Home → Game Settings → Security and turn ON Allow HTTP Requests, then click Save.
  4. If Roblox Studio shows a popup asking to allow local requests to 127.0.0.1, click Allow.
  5. Look for the AstraBlox toolbar panel in Studio's Plugins tab (the Studio Output window will print [AstraBlox] Bridge loaded) and verify the bridge status pill in AstraBlox turns green.

5. Build Your First Game

Switch back to Chat in AstraBlox and try a starter prompt, such as:

"Create a complete 10-stage lava obby with checkpoints, stage UI, leaderstats, and a spawn lobby."

Watch the header Performance Monitor pill to track live agent progress, Studio operations, and timing.


Updating AstraBlox

AstraBlox checks GitHub Releases on its own. When a new version is out, a popup offers Update now, What's new, Remind me later and Skip this version.


Uninstalling

You'll be asked whether to keep your projects, chats, keys and skills (~/.astrablox) in case you reinstall.

The uninstaller also removes the Roblox Studio plugin.


Need Setup Help?