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
- Double-click
AstraBloxSetup.exe. - If Microsoft Defender SmartScreen shows "Windows protected your PC", click More info → Run anyway. (New indie apps show this until they are code-signed.)
- Accept the license and click Install. AstraBlox installs into
%LOCALAPPDATA%\Programs\AstraBloxand adds Desktop and Start Menu shortcuts. - 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:
- Open the
.dmgand drag AstraBlox Studio onto Applications. - 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.) DownloadAstraBlox-mac-arm64.dmgfor Apple Silicon (M1–M4) orAstraBlox-mac-x64.dmgfor Intel Macs. Not sure? Apple menu → About This Mac: "Chip: Apple M…" means Apple Silicon, "Processor: Intel" means Intel. - 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:
- Claude Subscription (Claude Code) — Click Connect Claude subscription, sign in in the browser popup, then click Check status and Use Claude for chat (no separate API key needed if you have Claude Pro/Max).
- ChatGPT Subscription (Codex OAuth) — Click Connect ChatGPT subscription, sign in with ChatGPT Plus/Pro, then click Check status and Use ChatGPT for chat.
- Google Antigravity & Gemini — Click Connect / Switch Account (or paste a Gemini
AIza...API key). - AgentRouter / Custom OpenAI-Compatible API — Paste your Base URL + API Key, select your model, and click Save & Activate.
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:
- 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.luainto Roblox's plugins folder with your paired token (%LOCALAPPDATA%\Roblox\Pluginson Windows,~/Documents/Roblox/Pluginson Mac, inside Vinegar's prefix on Linux). - Restart Roblox Studio and open any place (published or local
.rbxlfile). - In Roblox Studio, open Home → Game Settings → Security and turn ON Allow HTTP Requests, then click Save.
- If Roblox Studio shows a popup asking to allow local requests to
127.0.0.1, click Allow. - 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.
- Update Center (Settings): turn on automatic checks, automatic install, or the beta channel, and see your update history.
- Every download is checked against its SHA-256 checksum before it installs, and the previous version is kept as a backup.
Uninstalling
You'll be asked whether to keep your projects, chats, keys and skills (~/.astrablox) in case you reinstall.
- Any system: Settings → Uninstall inside AstraBlox.
- Windows: Settings → Apps → Installed apps → AstraBlox Studio → Uninstall, or the Uninstall AstraBlox Studio Start-menu shortcut.
- Mac: double-click Uninstall AstraBlox.command in the DMG, or drag the app from Applications to the Trash.
- Linux: run
~/.local/share/astrablox-app/uninstall.sh(tar.gz install), or just delete the AppImage.
The uninstaller also removes the Roblox Studio plugin.
Need Setup Help?
- Check the Configuration Guide and FAQ
- Join our Discord Community (
discord.gg/25buSZhsd5) for direct setup help - Report bugs on GitHub Issues