Learn Gizlang

// The language: TypeScript compiled to native code. Types, unions, switch and exceptions.
type Shape = { kind: "circle"; r: number } | { kind: "square"; side: number };

function area(s: Shape): number {
    switch (s.kind) {
        case "circle": return Math.PI * s.r * s.r;
        case "square": return s.side * s.side;
    }
}

function half(n: number): number {
    if (n % 2 !== 0) throw new Error(`${n} is odd`);
    return n / 2;
}

function main(): void {
    const shapes: Shape[] = [{ kind: "circle", r: 1 }, { kind: "square", side: 2 }];
    for (const s of shapes) console.log(`area ${area(s).toFixed(2)}`);
    for (const n of [12, 6]) {
        try {
            console.log(`${n} / 4 = ${half(half(n))}`);
        } catch (e) {
            console.log(`${n}: ${e.message}`);
        }
    }
}

area 3.14
area 4.00
12 / 4 = 3
6: 3 is odd

// Tasks: Task.parallel runs a body on every core and gives the results in order.
import * as Task from "gizlang:task";

function main(): void {
    const squares = Task.parallel(8, (i: i64): i64 => { return i * i; });
    let sum = 0;
    for (const s of squares) { sum += s; }
    print(`${squares.map((s: i64): string => { return string(s); }).join(" ")} sum ${sum}`);
}

0 1 4 9 16 25 36 49 sum 140

// GizDB in the program: a database in a folder, SQL with parameters, no server.
import {System} from "gizlang:system";
import * as Embedded from "gizdb:embedded";

function main(sys: System): void {
    const folder = sys.temporaryDir();
    const db = Embedded.open(sys, folder.temporaryPath());
    db.exec("CREATE TABLE notes (id INT PRIMARY KEY, title TEXT, stars INT)");
    db.query("INSERT INTO notes VALUES ($1, $2, $3)", ["1", "Buy milk", "2"]);
    db.query("INSERT INTO notes VALUES ($1, $2, $3)", ["2", "Write the tour", "5"]);
    for (const row of db.query("SELECT title, stars FROM notes WHERE stars > $1", ["3"]).rows) {
        print(`${row[0] ?? ""} ${row[1] ?? ""}`);
    }
    db.close();
}

Write the tour 5

// A site from files, like PHP or Next.js: every .ghtml, .md and .html file of pages/ is an address (docs/reference/ghtml.md).
// Run: giz examples/web/pages/main.giz, then open http://127.0.0.1:8080
import {System} from "gizlang:system";
import * as Web from "gizweb";
import * as Pages from "gizweb:pages";
import {site} from "./pages/.routes";

function main(sys: System): i64 {
    return Web.listen(
        sys,
        8080,
        Pages.shell(""),
        Web.serving(),
        (own: System) => Pages.handler(site(), Pages.shell(""), Pages.standalone(own))
    );
}

<script>
    const slug = params.get("slug");
</script>
<article>
  <h1>Post: {slug}</h1>
  <p><a href="/blog">All posts</a></p>
</article>

// gizai: tensors on the CPU, or on a GPU when the machine has one.
import * as TensorCore from "gizai:tensor/core";

function main(): void {
    const a = TensorCore.tensor([2, 3], [1.0, 2.0, 3.0, 4.0, 5.0, 6.0]);
    const b = TensorCore.tensor([3, 2], [1.0, 0.0, 0.0, 1.0, 1.0, 1.0]);
    print(a.matmul(b).text());
}

[[4, 5], [10, 11]]

// gizfs: buckets and objects, here in an embedded store in a folder.
import {System} from "gizlang:system";
import {embedded} from "gizfs:node";
import * as Object from "gizfs:object";

function main(sys: System): void {
    const folder = sys.temporaryDir()!;
    const store = embedded(sys, folder.temporaryPath()!, "me").unwrap();
    store.changeObject(Object.Command.bucket("me", "photos", false)).unwrap();
    store.put("photos", "2026/hello.txt", utf8("Hello"), "text/plain").unwrap();
    print(string(store.get("photos", "2026/hello.txt", 0).unwrap()));
    store.close();
}

Hello

// gizhw: the machine's devices and sensors, read from the operating system.
import {System} from "gizlang:system";
import * as Device from "gizhw:device";

function main(sys: System): void {
    print(Device.platform(sys));
    for (const s of Device.sensors(sys).valueOr([])) { print(`${s.device} ${s.channel} ${s.value}`); }
}

giz ai chat qwen3.5-4b "Name three rivers."

// TypeScript on the Gizlang VM: Node's modules work, with no Node.js installed.
import { createHash } from "node:crypto";

const words: string[] = "the cat and the dog".split(" ");
const counts = new Map<string, number>();
for (const w of words) counts.set(w, (counts.get(w) ?? 0) + 1);
console.log([...counts].map(([w, n]) => `${w}=${n}`).join(" "));
console.log(createHash("sha256").update("gizlang").digest("hex").slice(0, 16));

the=2 cat=1 and=1 dog=1
db69adfa269a71dd

# Python on the Gizlang VM: the program runs in the VM's interpreter and JIT.
import json

counts = {}
for word in "the cat and the dog".split():
    counts[word] = counts.get(word, 0) + 1
print(json.dumps(counts, sort_keys=True))

{"and": 1, "cat": 1, "dog": 1, "the": 2}