Skip to content

uiua-lang/uiua

Repository files navigation

Uiua

Uiua (pronounced "wee-wuh") is a stack-based array programming language.

Documentation, examples, and an online interpreter can be found at uiua.org.

You can also check out the Discord server.

You can support Uiua's development via GitHub Sponsors.

Installation

You can try the language without installing anything on the website.

If you want to install the interpreter locally there are 2 options:

  • If your OS is supported, you can simply download the latest release.

  • If not, you will need to install via Cargo. This requires Rust (>=1.75) to be installed.

    You can install with one of the following commands:

    cargo install uiua -F full # Installs all features
    cargo install uiua         # No audio, webcam, or window features
    

    On Linux, you may need to install some dependencies first:

    apt install libx11-dev libffi-dev
    

    The following optional features are available but not enabled by default (enabled by passing --features <feature>):

    • full: Enables all optional features below
    • audio: Enables audio system functions (may require libasound2-dev libudev-dev pkg-config on Linux)
    • webcam: Enables webcam system functions (may require libjpeg-dev on Linux)
    • window: Enables output in a window
  • If you want the most recent development version of Uiua, you can install from the git repository.

    cargo install --git https://github.com/uiua-lang/uiua uiua -F full
    cargo install --git https://github.com/uiua-lang/uiua uiua
    
  • If you use Nix or NixOS, you can clone this repo and do following:

    nix develop    # to drop into a shell prompt with all the dependencies
    cargo check    # to make sure you can compile/build latest version
    cargo build    # to build latest debug version of uiua
    cargo run repl # to get uiua repl
    

    nix develop is not necessary if you have direnv active, in that case direnv allow will activate the flake devshell.

    Note: If you encounter errors such as rustc or any other package version mismatch, it is most likely that flake.lock file needs to be updated to pull in updated dependencies for nix shell.

Language and Font Support

The Uiua native interpreter has a built-in language server that can be used by editor extensions.

You can find a list of editor extensions here.

You can find a list of fonts that support Uiua's characters here.