Skip to content
rmichaelthomasPublic

Latest commit

 

History

567 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Guion

A general-purpose programming language for software that is easier to write, understand and run.

Latest release MIT license Built with Rust Try it in your browser

Website · Getting started · Reference · Download


Guion (say GUY-on) is a programming language for everyday work: scripts, command-line tools, data processing, web requests, and full applications. It aims to be easy to read, hard to get wrong, and fast to run.

Guion is young. Version 0.7.0 is out for Linux, macOS (Apple Silicon and Intel) and Windows, with a written stability policy for what stays compatible between releases. The language is still changing between minor releases. Every speed and quality claim the project makes is measured, and the results are published with their raw data, including the places where Guion still falls short.

A first look

record Item:
    name: Text
    price: Int
    quantity: Int

fn line_total(item: Item) -> Int:
    return item.price * item.quantity

fn main() -> Int:
    let cart = [Item("notebook", 4, 3), Item("pen", 2, 5)]
    var total = 0
    for item in cart:
        set total = total + line_total(item)
    print(total)
    return 0
$ guion run main.gu
22

Mistakes are caught before the program runs. Each one points at the exact spot and carries a stable code that people and tools can look up:

$ guion check mistake.gu
mistake.gu:2:19: error[E_TYPE_OPERATOR]: operator `+` does not accept these operand types

You can try these examples and others in your browser without installing anything.

Why Guion

  • Easy to read. Indentation-based syntax that feels familiar if you know Python, with types that are written where they help and inferred where they don't.
  • Errors you can act on. Programs are checked before they run. Every error has a stable code and a suggested repair, as text for people and as JSON for tools and AI assistants.
  • One command for the whole project. guion creates, checks, formats, lints, tests, runs, builds, packages, installs and documents programs. There is nothing else to install or configure.
  • Permissions by default. A program can't touch files, the network or the environment unless it's given permission. You can see what a program is able to do before you run it.
  • Fast. On measured everyday workloads, from text processing to JSON and CSV, Guion runs faster than CPython. The results are below.
  • Built in itself. The Guion compiler is written in Guion and runs on a Rust runtime. Compiled programs are portable .gub files.
  • Runs in the browser. The same runtime compiles to WebAssembly, which is how the website runs your code.

Install

Homebrew (macOS and Linux)

brew install rmichaelthomas/guion/guion

One-line installer (macOS and Linux)

curl -fsSL https://raw.githubusercontent.com/rmichaelthomas/guion/main/distribution/get-guion.sh | sh

It picks the archive for your machine, checks its checksum and installs under ~/.local (--prefix DIR chooses another place, --version X.Y.Z another release). Read the script first if you like: it is distribution/get-guion.sh.

Download an archive

Every archive is on the v0.7.0 release with a matching .sha256 file. You don't need Rust or Python installed.

Machine Archive
macOS, Apple Silicon (signed, notarized) guion-macos-aarch64.tar.gz
macOS, Intel (signed, notarized) guion-macos-x86_64.tar.gz
Linux, Debian 12-compatible, x86_64 guion-debian-x86_64.tar.gz
Linux, Debian 12-compatible, ARM64 guion-debian-aarch64.tar.gz
Windows, x86_64 (not signed) guion-windows-x86_64.zip

On macOS and Linux:

shasum -a 256 -c guion-macos-aarch64.tar.gz.sha256     # sha256sum -c on Linux
tar -xzf guion-macos-aarch64.tar.gz
cd guion-macos-aarch64
sh install.sh                           # installs under ~/.local; pass a path to choose another place

The Mac builds are signed with a Developer ID certificate and notarized by Apple, so macOS opens them without a warning. The first launch checks with Apple, so it needs an internet connection (a bare command-line binary cannot carry the notarization ticket with it).

On Windows, unzip the archive and add its bin folder to your PATH. The Windows build is not signed, so Windows may warn the first time you run it. The Intel Mac and Windows builds were built and smoke-tested on GitHub's runners; the Windows build has not been through the full test suite.

Other systems

For other Linux distributions you can build from source with Rust:

git clone https://github.com/rmichaelthomas/guion.git
cd guion
cargo build --release --locked -p guion-cli
./target/release/guion --version

Quick start

guion new hello        # create a project
guion run hello        # prints: Hello, Guion!
guion test hello       # run its tests
guion check hello/src/main.gu

The getting-started guide goes further.

How it compares with Python

On November 3, 2026, Guion ran faster than CPython 3.14.7 on every text, JSONL and CSV workload in the project's speed gate. The gate ran on both x86_64 and ARM64 Linux servers, at 20,000 and 200,000 rows. A ratio below 1.0 means Guion took less time.

Workload, 200,000 rows x86_64 ARM64
Text: split, trim, replace, find 0.96× 0.81×
JSONL event summary 0.86–0.90× 0.84–0.86×
CSV ledger 0.86–0.88× 0.79–0.80×

Earlier tests on a Mac found Guion 2.7× faster on the Richards benchmark and faster in all nine everyday applications tested. These results cover the workloads named here, not every program. The speed-gate report and the website give the method, the raw samples and the limits.

Where Python is still ahead

Python is mature and widely used. Here is where it's still ahead of Guion today:

  • Libraries and packages. Guion ships 35 standard-library modules, including JSON, CSV, TOML, SQLite, HTTP, files, text, time, random and regex, plus a package manager and a package registry with a signed log. The registry is live and holds two packages: frames (guion add frames) and web (guion add web --approve-capabilities).
  • Arrays and data science. Guion has native n-dimensional arrays and a first-party frames data-frame library, but both are young. In the committed reports on one Apple M1 Pro, frames finishes five tested CSV workloads before pandas does end to end (mostly because pandas takes about 0.26 s to load). On compute alone, reading a large CSV is still about 3 times pandas, and array maths is about 1.4 to 2.3 times NumPy's (speed report).
  • Long-term stability. There is a written stability policy, but Guion is pre-1.0 with a short track record, and the Intel Mac and Windows builds are new and lightly tested.

Documentation

The name

Guion is named in honour of Guion S. "Guy" Bluford Jr., the NASA astronaut who in 1983 became the first African American to fly in space. It's pronounced GUY-on.

Contributing

Issues and pull requests are welcome; see CONTRIBUTING.md. Please report security problems privately as described in SECURITY.md.

License

Guion is released under the MIT License. Third-party components are listed in THIRD-PARTY-NOTICES.md.

Releases

Packages

Contributors

Languages