A general-purpose programming language for software that is easier to write, understand and run.
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.
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
22Mistakes 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 typesYou can try these examples and others in your browser without installing anything.
- 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.
guioncreates, 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
.gubfiles. - Runs in the browser. The same runtime compiles to WebAssembly, which is how the website runs your code.
brew install rmichaelthomas/guion/guioncurl -fsSL https://raw.githubusercontent.com/rmichaelthomas/guion/main/distribution/get-guion.sh | shIt 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.
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 placeThe 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.
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 --versionguion new hello # create a project
guion run hello # prints: Hello, Guion!
guion test hello # run its tests
guion check hello/src/main.guThe getting-started guide goes further.
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.
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) andweb(guion add web --approve-capabilities). - Arrays and data science. Guion has native n-dimensional arrays and a first-party
framesdata-frame library, but both are young. In the committed reports on one Apple M1 Pro,framesfinishes 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.
- Getting started
- Language and command reference
- Language specification
- Guide for AI coding assistants and runnable recipes
- Architecture
- Browser WebAssembly interface
- Compatibility and migration
- Stability policy
- Current status and all measured results
- Changelog
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.
Issues and pull requests are welcome; see CONTRIBUTING.md. Please report security problems privately as described in SECURITY.md.
Guion is released under the MIT License. Third-party components are listed in THIRD-PARTY-NOTICES.md.