Install

BrainRot Lang ships as a single binary with zero dependencies. Download the latest release and add it to your PATH — no build tools required.

Step 1 — Download

Download brainrot.exe (Windows) or brainrot (macOS/Linux) from the latest release:

https://github.com/Tanveer-rajpurohit/brainrot-lang/releases/tag/v1.0.2

Step 2 — Create a folder

Create a dedicated folder to store the BrainRot binary. On Windows, a common location is C:\brainrot.

Windows

# Create a dedicated folder for BrainRot
mkdir C:\Users\USERNAME\brainrot

Step 3 — Move the binary

Move the downloaded brainrot.exe into the folder you just created.

Windows

# Move the downloaded exe into the folder
move brainrot.exe C:\Users\USERNAME\brainrot\

Step 4 — Add to PATH

Add the folder to your system's PATH environment variable so you can run brainrot from any directory.

Windows — set PATH

# Add to PATH via Settings:
#   1. Open Settings → System → About → Advanced System Settings
#   2. Click "Environment Variables"
#   3. Under "System variables", find and select "Path"
#   4. Click "Edit" → "New"
#   5. Add: C:\Users\USERNAME\brainrot
#   6. Click OK to save
#
# Or via PowerShell (run as Administrator):
[System.Environment]::SetEnvironmentVariable(
    "Path",
    $env:Path + ";C:\Users\USERNAME\brainrot",
    [System.EnvironmentVariableTarget]::Machine
)

Important: After adding to PATH, you must open a new terminal window for the change to take effect.

Step 5 — Verify

Open a new terminal and run brainrot help to verify the installation.

terminal

# Open a NEW terminal and run:
brainrot help

# Expected output:
# Usage: brainrot <command> <file>
#
# Commands:
#   run      Execute a .brt source file
#   tokens   Display the lexer token stream
#   ast      Display the parsed AST
#   help     Show this help message

macOS / Linux

On macOS or Linux, download the binary from releases, make it executable, and move it to a directory on your PATH.

Mac / Linux

# Make the downloaded binary executable
chmod +x brainrot

# Move to a directory on your PATH
sudo mv brainrot /usr/local/bin/

# Verify
brainrot help

Build from Source

If you prefer building from source (requires Go 1.21+), clone the repo and use go build.

build from source

# Requires Go 1.21+
git clone https://github.com/Tanveer-rajpurohit/brainrot-lang.git
cd brainrot-lang
go build -o brainrot.exe main.go

# Cross-compile for other platforms:
GOOS=darwin GOARCH=amd64 go build -o brainrot main.go
GOOS=linux GOARCH=amd64 go build -o brainrot main.go

Next: Quickstart →