v0.2.1

📦 QCLang — User Installation & Usage Guide

This guide explains how to install and use QCLang on Windows and Linux using prebuilt binaries.
Latest stable release: v0.2.1

Note: QCLang is a systems-level tool designed for performance and safety.

---

🪟 Windows Installation

Step 1: Download and Extract

1. Download qclang-windows-x86_64.zip from Assets below.
2. Extract the ZIP to C:\Program Files\QCLang\.
3. Note: The binary is already named qclang.exe inside the zip.

Step 2: Add to PATH (Permanent)
To run qclang from any terminal, add the release folder to your System Path.

Method A: PowerShell (Recommended)
Right-click Start → Terminal (Admin) and run:

$folder = "C:\Program Files\QCLang"
$oldPath = [Environment]::GetEnvironmentVariable("Path", "Machine")
if ($oldPath -notlike "*$folder*") {
    [Environment]::SetEnvironmentVariable("Path", "$oldPath;$folder", "Machine")
    Write-Host "Success! Restart your terminal to use qclang." -ForegroundColor Green
}

Step 3: Verify
Open a new terminal window:

qclang --version

---

🐧 Linux Installation

Step 1: Download and Prepare

# Extract
tar -xzf qclang-linux-x86_64.tar.gz

# Navigate (binary is already named 'qclang')
chmod +x qclang

Step 2: Install System-Wide

sudo mv qclang /usr/local/bin/

# Verify
qclang --version

---

🧪 Basic Usage

1. Compile to OpenQASM
Generate OpenQASM 2.0 code from your .qc source:

qclang compile my_circuit.qc --show

2. Semantic Check
Validate your code (Affine Type checks, qubit ownership) without compiling:

qclang check my_circuit.qc

3. Auto-Update
Run the interactive updater:

qclang update

v0.1.4

---

📦 QCLang — User Installation & Usage Guide

This guide explains how to install and use QCLang on Windows and Linux using prebuilt binaries.

Latest stable release: v0.4.x
Note: QCLang is a systems-level tool designed for performance and safety.

---

🪟 Windows Installation

Step 1: Download and Extract

1. Download qclang-windows-x86_64.zip from [GitHub Releases](https://www.google.com/search?q=https://github.com/Asmodeus14/qclang/releases).
2. Extract the ZIP to C:\Program Files\QCLang\.
3. Rename the file: Inside the release folder, rename qclang-windows-x86_64.exe to qclang.exe.

Step 2: Add to PATH (Permanent)

To run qclang from any terminal, add the release folder to your System Path:

Method A: PowerShell (Recommended)

Right-click Start → Terminal (Admin) and run:

# Pointing specifically to the release subfolder
$folder = "C:\Program Files\QCLang\release"
$oldPath = [Environment]::GetEnvironmentVariable("Path", "Machine")
if ($oldPath -notlike "*$folder*") {
    [Environment]::SetEnvironmentVariable("Path", "$oldPath;$folder", "Machine")
    Write-Host "Success! Restart your terminal to use qclang." -ForegroundColor Green
}

Method B: Windows GUI

1. Search for "Edit the system environment variables" and open it.
2. Click Environment Variables.
3. Under System variables, select Path → Edit.
4. Click New and paste: C:\Program Files\QCLang\release
5. Click OK on all windows.

Step 3: Verify

Open a new terminal window:

qclang --version

---

🐧 Linux Installation

Step 1: Download and Prepare

# Extract
tar -xzf qclang-linux-x86_64.tar.gz

# Navigate to the binary and rename
cd release
mv qclang-linux-x86_64 qclang
chmod +x qclang

Step 2: Install System-Wide

sudo mv qclang /usr/local/bin/
# Verify
qclang --version

---

🧪 Basic Usage

1. Compile to OpenQASM

Generate OpenQASM 2.0 code from your .qc source:

qclang compile my_circuit.qc --show

2. Semantic Check

Validate your code (Affine Type checks, qubit ownership) without compiling:

qclang check my_circuit.qc

---