Install
Run this in a terminal on macOS (Apple Silicon) or Linux (x64). On Windows, run it inside WSL (Windows Subsystem for Linux):ssh-keygen, when your computer has OpenSSH) and the published SHA-256
checksum, installs it in ~/.aius and adds ~/.aius/bin to your PATH.
aius upgrade checks the signature itself before it installs a new version.
aius works in the same terminal right away when a folder of your own on its
PATH can hold a link to it, such as ~/.local/bin or Homebrew’s
/opt/homebrew/bin; the installer says Linked … then. Otherwise it tells you
to run . ~/.aius/env once in that terminal; new terminals have aius either
way. Check it:
aius command is already in ~/.aius/bin, the installer keeps it as
aius.backup-… next to the new one.
Update when AIUS asks: a terminal that is signed in checks for a newer version when it starts, and every few
hours while it stays open. It asks before changing anything. Upgrade now installs the new version in the background,
then Restart now reopens the session you were in on the new version. Later asks again the next time you start
AIUS, and Skip this version waits for the next one. You can also update at any time by running aius upgrade, or
the install command again. To stop the question, set "autoupdate": false in ~/.config/aius-agent/aius.json.
The sign-in window offers a newer version too (Ctrl+U), since an older AIUS may not be able to
sign in.
Install a specific version,
for example to go back to the one you had, by setting AIUS_VERSION:
~/.aius, the aius link the installer may have put
in ~/.local/bin, ~/bin or Homebrew’s bin, and the # AIUS lines it 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 firstaius 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 status prints the account the terminal is signed in to, after
checking with AIUS Light that the sign-in still holds.
Changing your password or two-factor authentication on the web, or losing your
access, ends the terminal’s sign-in. AIUS then shows the sign-in window again
and says why; your sessions stay on this computer and open where you were once
you sign in. aius platform status says so too, and exits with an error.
Checking the installed version and the signed-in account
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:
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.