Skip to main content

Install Aegis

For macOS and Linux, the supported public install path is:

curl -fsSL https://aegis.agentic-in.ai/install.sh | bash

This installer:

  • creates a Python runtime under ~/.aegis/venv
  • writes a launcher to ~/.local/bin/aegis
  • prepares durable state in ~/.aegis/state
  • prepares the default profile in ~/.aegis/profile
  • launches aegis automatically after install
  • does not require a local repo checkout
  • installs the latest published development aegis-ag package by default

The packaged install already includes the built-in Skills catalog. Extra public skills, when you want them later, remain explicit operator-installed flows inside the CLI rather than part of the public website install path. The packaged launcher also exposes aegis skills directly, so you can inspect or install skills before opening wake.

System requirements​

  • Python 3.12 or newer on PATH
  • macOS or Linux
  • outbound network access to install the current Aegis package

Choose the stable channel instead​

If you want the latest stable package instead of the current development build:

curl -fsSL https://aegis.agentic-in.ai/install.sh | bash -s -- --channel stable

Install to a custom location​

curl -fsSL https://aegis.agentic-in.ai/install.sh | bash -s -- \
  --install-root "$HOME/.agentic/aegis" \
  --bin-dir "$HOME/.local/bin"

Useful flags:

  • --install-root <path> changes the durable runtime location
  • --bin-dir <path> changes where the aegis launcher is written
  • --python <path> chooses a specific Python interpreter
  • --channel stable switches from the default dev package stream to the latest stable package
  • --pip-spec <spec> pins an explicit package or local path when you need a one-off build
  • --skip-run skips the automatic aegis launch

The launcher also prepares a dedicated gateway state path at $AEGIS_HOME/state/gateway, exposed as AEGIS_GATEWAY_STATE_DIR, so the messaging gateway no longer reuses the same durable directory name as the main CLI runtime.

Upgrade an existing install​

curl -fsSL https://aegis.agentic-in.ai/install.sh | bash -s -- upgrade

Contributor path: install from a repo checkout​

If you are working from a local clone of the repository, use the repo-local installer instead:

git clone https://github.com/agentic-in/aegis.git
cd aegis
bash scripts/install.sh

That path keeps the launcher pointed at your checkout, which is what you want for development and debugging. It also keeps the private operator dashboard frontend assets on disk, which is what aegis dashboard needs.

Verify the install​

aegis
aegis status
aegis skills
aegis gateway doctor

If aegis is not found, add ~/.local/bin to PATH and open a new shell.