Installation¶

Stable release¶

To install IRx, run this command in your terminal:

$ pip install pyirx

This is the preferred method to install IRx, as it will always install the most recent stable release.

If you don't have pip installed, this Python installation guide can guide you through the process.

From sources¶

The sources for IRx can be downloaded from the Github repo.

You can either clone the public repository:

$ git clone https://github.com/arxlang/irx

Or download the tarball:

$ curl -OJL https://github.com/arxlang/irx/tarball/main

Once you have a copy of the source, you can install it with:

$ poetry install

Note for contributors

If you are setting up a development environment to run tests or contribute code, please follow the steps in the Contributing guide instead. The development workflow requires creating the Conda environment first, then installing Poetry dependencies:
mamba env create --file conda/dev.yaml
conda activate irx
poetry install
See the full instructions at: https://irx.arxlang.org/contributing/

Toolchain notes¶

IRx emits PIC-compatible object files by default so they can link on toolchains that default to PIE executables (common on modern Linux distributions and Conda environments).

If you still hit a PIE mismatch linker error (for example R_X86_64_32 while linking), verify you are using a recent IRx/Arx version. As a temporary workaround for external/manual linking, use:

clang -no-pie file.o -o program