A lightweight, project-based AI agent runtime. আলো — "The Light".
Install
One command. Non-interactive — it installs Alo and puts alo on your PATH, then prints the next steps.
Pin a version or change the install dir:
What the installer does
1 · Download & verify
Pulls alo-agent-<ver>.tar.gz + its sha256 from /releases/ and checks the checksum.
2 · Install
Extracts to ~/.local/share/alo, creates a venv, and runs pip install -e .[all].
3 · PATH
Symlinks alo into ~/.local/bin — run hash -r (or open a new shell) to pick it up.
Prerequisites
Python ≥ 3.10
python3 --version. Override with ALO_PYTHON if your 3.10+ lives elsewhere.
curl or wget
Plus tar and sha256sum/shasum for the checksum check.
~/.local/bin on PATH
Standard on most distros; the installer creates it if missing.
node + npm (optional)
Only for the IMAP email client tools (email_check/sync/fetch/search/send). Email notifications via cron use stdlib SMTP and need no node.
On Debian/Ubuntu, if python3-venv (ensurepip) is missing, the installer offers to sudo apt install it for you before downloading anything. The installer prints a live ✓/✗ prerequisites checklist at startup.
Setup after install
The installer doesn't configure anything — these are your next steps.
$ alo --version
$ alo setup # provider · model · API key
$ cd <your-project> && alo init # scaffold .alo/ + PROJECT_CONTEXT.md
Optional — run the HTTP server as a systemd service:
Upgrade & uninstall
Uninstall (removes the install dir + PATH symlink; leaves your workspaces in place):
Or manually: rm -rf ~/.local/share/alo ~/.local/bin/alo