Install

Run this in a terminal on macOS (Apple Silicon) or Linux (x64):
curl -fsSL https://light.aius.co/install.sh | bash
The installer downloads AIUS for your computer, checks it against the published SHA-256 checksum, installs it in ~/.aius and adds ~/.aius/bin to your PATH. Open a new terminal and check it:
aius --version
If an aius command is already in ~/.aius/bin, the installer keeps it as aius.backup-… next to the new one. Update by running aius upgrade, or the install command again. Install a specific version, for example to go back to the one you had, by setting AIUS_VERSION:
curl -fsSL https://light.aius.co/install.sh | AIUS_VERSION=<version> bash
Uninstall by deleting ~/.aius/bin/aius and ~/.aius/releases, and the # AIUS lines the installer added to your shell profile (~/.zshrc, ~/.bashrc or ~/.bash_profile). Your sessions, sign-in and settings are in ~/.local/share/aius-agent, ~/.local/state/aius-agent, ~/.cache/aius-agent and ~/.config/aius-agent; delete those folders too to remove them.

Sign in

The first aius start asks you to sign in (see Quickstart). On a server without a browser, sign in with a code instead and approve it from any other device:
aius platform login --device
aius platform status
aius platform status prints the account the terminal is signed in to.
A terminal where aius --version prints the installed version and aius platform status prints Signed in as ana.lopez@example.com on https://light.aius.co
aius platform logout signs this terminal out and revokes its access; your browser session is separate.

Python for data work

The data tools run Python on your computer, in the environment of the project you are working in. AIUS looks for an interpreter in this order: the project’s .venv, then an active virtual environment (VIRTUAL_ENV), then an active conda environment (CONDA_PREFIX), then python3. A project-local environment keeps each analysis reproducible:
python3 -m venv .venv
.venv/bin/python -m pip install pandas numpy scikit-learn matplotlib duckdb pyarrow
CapabilityPackages
Profiling, cleaning, modellingpandas, numpy, scikit-learn
SQL over CSV, Parquet, Excel and DuckDB filesduckdb, pyarrow
Figuresmatplotlib
Notebooksnbformat, nbclient, ipykernel
AIUS never installs packages on its own. When a package is missing, the agent names the one install command it needs and waits for you to approve it. Ask it to check the environment at any time; its python_environment tool reports the interpreter it selected and the packages it found.