Installation

Install BanglaCode on your machine and start coding in Bengali. Use our one-liner installers, download pre-built binaries, or build from source.

🚀 Quick Install (Recommended)

The fastest way to install BanglaCode. Our installer automatically detects your operating system and architecture.

Linux / macOS / BSD

curl -fsSL https://raw.githubusercontent.com/nexoral/BanglaCode/main/Scripts/install.sh | bash

Supports: Ubuntu, Debian, Fedora, RHEL, CentOS, Arch, macOS (Intel & Apple Silicon), FreeBSD, OpenBSD, NetBSD, and more.

Windows (PowerShell)

irm https://raw.githubusercontent.com/nexoral/BanglaCode/main/Scripts/install.ps1 | iex

Works on Windows 7+, Windows 10/11, and Windows Server. Supports x64, x86, and ARM64.

📦 Download Pre-built Binaries

Download the appropriate package for your system from our GitHub Releases.

📋 Manual Installation

Linux (DEB - Debian/Ubuntu)

# Download the .deb file, then:
sudo dpkg -i banglacode-linux-amd64.deb

Linux (RPM - Fedora/RHEL/CentOS)

# With dnf
sudo dnf install ./banglacode-linux-amd64.rpm

# Or with yum
sudo yum install ./banglacode-linux-amd64.rpm

Linux/macOS/BSD (tar.gz)

# Extract and install
tar -xzf banglacode--.tar.gz
sudo mv banglacode /usr/local/bin/
sudo chmod +x /usr/local/bin/banglacode

Windows (ZIP)

1. Download the appropriate ZIP file
2. Extract to a folder (e.g., C:\Program Files\BanglaCode)
3. Add the folder to your system PATH:
   • Search "Environment Variables" in Windows
   • Edit "Path" under User variables
   • Add the folder containing banglacode.exe
4. Restart your terminal

🔐 Verify Download (Optional)

Each release includes a checksums.txt file with SHA256 hashes. Verify your download:

# Download checksums.txt from the release, then:
sha256sum -c checksums.txt --ignore-missing

🔧 Build from Source

Prerequisites

To build from source, you need Go 1.20 or later. Download it from go.dev/dl.

go version
# Should show: go version go1.20+ ...

Build Steps

# Clone the repository
git clone https://github.com/nexoral/BanglaCode.git
cd BanglaCode

# Build
go build -o banglacode main.go

# Verify
./banglacode --version

# Optional: Install system-wide
sudo mv banglacode /usr/local/bin/

Cross-Compilation

Build for different platforms:

# Windows (64-bit)
GOOS=windows GOARCH=amd64 go build -o banglacode.exe main.go

# macOS (Apple Silicon)
GOOS=darwin GOARCH=arm64 go build -o banglacode main.go

# Linux (ARM64 - Raspberry Pi 4)
GOOS=linux GOARCH=arm64 go build -o banglacode main.go

# FreeBSD
GOOS=freebsd GOARCH=amd64 go build -o banglacode main.go

✅ Verify Installation

banglacode --version

🎯 Running Your First Program

Create a File

Create a file named hello.bang:

1
// Your first BanglaCode program
2
dekho("Namaskar, BanglaCode!");
3
4
dhoro naam = "World";
5
dekho("Hello,", naam);

Run the Program

banglacode hello.bang

Output:

Namaskar, BanglaCode!
Hello, World

💻 Interactive REPL

Start the interactive mode by running without arguments:

banglacode

You'll see a prompt where you can type BanglaCode directly:

BanglaCode REPL v1.0
Type 'help' for commands, 'exit' to quit

>> dhoro x = 5
>> dekho(x * 2)
10
>> kaj double(n) { ferao n * 2; }
>> double(21)
42

🎨 VS Code Extension

For syntax highlighting and code snippets, install the BanglaCode VS Code extension:

1. Open VS Code
2. Go to Extensions (Ctrl+Shift+X)
3. Search for "BanglaCode"
4. Click Install

Or visit the VS Code Marketplace.

❓ Troubleshooting

Command not found

Make sure the binary is in your PATH:

# Check if banglacode is in PATH
which banglacode

# If not found, add to PATH (Linux/macOS)
echo 'export PATH="$PATH:/usr/local/bin"' >> ~/.bashrc
source ~/.bashrc

Permission denied (Linux/macOS)

chmod +x /usr/local/bin/banglacode

Windows: Script execution disabled

If the PowerShell installer is blocked:

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

Build errors

Make sure you have Go 1.20+ and all dependencies:

go mod tidy
go build -o banglacode main.go