Quick Start: Install Thagore

Quick Start: Install Thagore

Download a pre-built release from GitHub and write your first program in under 5 minutes. No build step, no bootstrap — CI/CD already did that for you.

---

Step 1: Install LLVM 21

Thagore needs LLVM 21.1.8 on your PATH. Run the official install script for your platform:

🐧 Linux (Ubuntu/Debian)

curl -fsSL https://raw.githubusercontent.com/thagore-foundation/thagore/refs/heads/main/scripts/install/ubuntu.sh | bash -s -- --yes

Installs LLVM 21 via the official apt.llvm.org repository.

🐧 Linux (generic)

curl -fsSL https://raw.githubusercontent.com/thagore-foundation/thagore/refs/heads/main/scripts/install/linux.sh | bash -s -- --yes

🍎 macOS

curl -fsSL https://raw.githubusercontent.com/thagore-foundation/thagore/refs/heads/main/scripts/install/macos.sh | bash -s -- --yes

Installs llvm@21 via Homebrew. Requires Homebrew.

🪟 Windows (PowerShell Admin)

irm https://raw.githubusercontent.com/thagore-foundation/thagore/refs/heads/main/scripts/install/windows.ps1 | iex

Installs LLVM 21.1.8 via winget or choco.

🔧 Portable (Android/BSD/…)

curl -fsSL https://raw.githubusercontent.com/thagore-foundation/thagore/refs/heads/main/scripts/install/portable.sh | bash -s -- --yes

Builds LLVM from source using cmake + ninja. Takes 30–60 min. Useful for Termux, FreeBSD, or any non-standard environment.

Verify:

clang --version
# clang version 21.1.8 ...

---

Step 2: Download the Compiler

Download the latest pre-built release (v0.3.33-foundation) for your platform:

🐧 Linux x86-64

curl -fsSL https://github.com/thagore-foundation/thagore/releases/download/v0.3.33-foundation/thagore-linux-x86_64.tar.gz | tar xz
chmod +x thagore

🐧 Linux ARM64

curl -fsSL https://github.com/thagore-foundation/thagore/releases/download/v0.3.33-foundation/thagore-linux-arm64.tar.gz | tar xz
chmod +x thagore

🍎 macOS ARM64

curl -fsSL https://github.com/thagore-foundation/thagore/releases/download/v0.3.33-foundation/thagore-macos-arm64.tar.gz | tar xz
chmod +x thagore

🪟 Windows

Invoke-WebRequest -Uri "https://github.com/thagore-foundation/thagore/releases/download/v0.3.33-foundation/thagore-windows-x86_64.zip" -OutFile thagore.zip
Expand-Archive thagore.zip -DestinationPath .

Verify:

./thagore --version

Add to PATH (optional)

To use thagore from anywhere, move it to a directory on your PATH:

# Linux / macOS
sudo mv thagore /usr/local/bin/thagore

# Windows — add the folder to your System PATH via Settings

---

Step 3: Write Your First Program

Create a file hello.tg:

hello.tg

func main() -> i32:
    print("Hello, Thagore!")
    return 0

Compile and run:

🐧 Linux / 🍎 macOS

./thagore build hello.tg -o hello
./hello

🪟 Windows

.\thagore.exe build hello.tg -o hello.exe
.\hello.exe

Hello, Thagore!

🎉 That’s it — you’re up and running!

---

Step 4: Try More Examples

Download and run examples directly from the repo:

# Fibonacci
curl -fsSL -o fib.tg https://raw.githubusercontent.com/thagore-foundation/thagore/refs/heads/main/examples/fib.tg
./thagore build fib.tg -o fib && ./fib
# 9227465

# Read user input
curl -fsSL -o input.tg https://raw.githubusercontent.com/thagore-foundation/thagore/refs/heads/main/examples/console_input_i32.tg
./thagore build input.tg -o input_demo && ./input_demo

# Structs
curl -fsSL -o method.tg https://raw.githubusercontent.com/thagore-foundation/thagore/refs/heads/main/examples/method.tg
./thagore build method.tg -o method && ./method

---

All Download URLs

LLVM Install Scripts

Platform	Script URL
Ubuntu / Debian	…/scripts/install/ubuntu.sh
Linux (generic)	…/scripts/install/linux.sh
macOS	…/scripts/install/macos.sh
Windows	…/scripts/install/windows.ps1
Portable (Android/BSD)	…/scripts/install/portable.sh

Base: https://raw.githubusercontent.com/thagore-foundation/thagore/refs/heads/main/

Compiler Releases (v0.3.35-foundation)

Platform	Asset
Linux x86-64	thagore-linux-x86_64.tar.gz
Linux ARM64	thagore-linux-arm64.tar.gz
macOS ARM64	thagore-macos-arm64.tar.gz
Runtime (Linux x86-64)	thagore-runtime-linux-x86_64.a
Runtime (Linux ARM64)	thagore-runtime-linux-arm64.a

→ All releases

---

What’s Next?

• 📖 Language Syntax — variables, functions, control flow
• ⌨️ Reading Input — input(), io.input_prompt()
• 📚 Standard Library — fs, io, string, process, path, http
• ⚙️ CLI Reference — all compiler flags
• 💡 Patterns & Idioms — best practices