🔒 Invite-only

This install is for invited operators

The from-GitHub install needs private-repo access. Reading the public story is open to all — to actually install, request an invite and you’ll get repo access.

▸ Request access

PRIVATE · P973

Shared in confidence with invited operators only. Please don’t redistribute the app, its keys/configs, or these guides — and never share API keys. See the LICENSE.

Install Brief v2.0 · AUSPEX

 █████╗ ███████╗ ██████╗ ██╗███████╗
██╔══██╗██╔════╝██╔════╝ ██║██╔════╝
███████║█████╗  ██║  ███╗██║███████╗
██╔══██║██╔══╝  ██║   ██║██║╚════██║
██║  ██║███████╗╚██████╔╝██║███████║
╚═╝  ╚═╝╚══════╝ ╚═════╝ ╚═╝╚══════╝

Installing from GitHub

Clone, install, open the console — everything renders in demo mode immediately. Pick your OS above; the commands adapt.

DEMO

Live vs demo — you’ll always know which is which. Sample data carries a holographic foil sheen; flipping a panel to live triggers an indicator flash and a notification. Real alerts are never disguised as demo.

Before you start

The dashboard runs in any modern browser. The relays need Python 3.11+. Real Windows endpoint telemetry needs Windows — on Linux / macOS it runs in mock mode. External tools (Kismet, Wireshark, Nmap…) are optional, added later.

Choose your install path

PATH A

Install with Git

The recommended route — updates with a single git pull.

Install the prerequisites

Once per machine: Git (git-scm.com) and Python 3.11+ (python.org) — tick “Add Python to PATH.”

bash

$ sudo apt install git python3 python3-pip   # Debian/Ubuntu
$ brew install git python                    # macOS

Clone the repo

Open PowerShell and run:

PowerShell

PS> cd $env:USERPROFILE\Downloads
PS> git clone https://github.com/ChalulaBottle/AEGIS.git
PS> cd AEGIS

bash

$ cd ~/Downloads
$ git clone https://github.com/ChalulaBottle/AEGIS.git
$ cd AEGIS

Private repo → GitHub prompts you to sign in the first time.

Install & start — one command

PowerShell

PS> .\aegis-install.ps1

bash

$ chmod +x aegis-install.sh
$ ./aegis-install.sh

Checks Python/Git, copies every config template to a real config without touching keys, installs the DeepRoot agent, then prints how to launch.

If PowerShell says “running scripts is disabled,” run once: Set-ExecutionPolicy -Scope CurrentUser RemoteSigned → Y.

Open the console

PowerShell

PS> .\aegis-dashboard\aegis_launch.ps1

bash

$ xdg-open aegis-dashboard/aegis_v1_5.html     # macOS: open ...

…or open aegis-dashboard/aegis_v1_5.html in any browser.

Turn panels live

Open Settings → Setup Center. Each integration shows a LIVE / DEMO dot, the config + key it needs, and a start command. Terminal: .\aegis-install.ps1 -Setup.

Update later

PowerShell

PS> git pull                 # or: .\aegis-install.ps1 -Update

bash

$ git pull                 # or: ./aegis-install.sh --update

Your keys survive — real configs are gitignored. The open dashboard shows a “reload to update” notice.

PATH B

Install from a ZIP

No git needed.

On the repo page click Code → Download ZIP (or a release ZIP like AEGIS-v2.0-AUSPEX.zip).

Extract it into your home / Downloads folder.

From the extracted folder:

PowerShell

PS> cd $env:USERPROFILE\Downloads\AEGIS
PS> .\aegis-install.ps1
PS> .\aegis-dashboard\aegis_launch.ps1

bash

$ cd ~/AEGIS
$ chmod +x aegis-install.sh
$ ./aegis-install.sh

PATH C

Portable .exe

Windows, no Python — run the DeepRoot agent by double-click.

Path C is Windows-only. On Linux / macOS use Path A or B; the agent runs in --mock.

Grab deeproot-kit.exe from the release (or build it — see deeproot-kit/PACKAGING.md).

From an Administrator PowerShell:

PowerShell · admin

PS> .\deeproot-kit.exe            # first run offers a setup wizard

Keep config.json and .anthropic_key next to the .exe.

CHECK

Verify it’s working

▸

The dashboard opens and tabs render — demo data is normal at first.

▸

Settings → Setup Center dots: green LIVE for running relays, amber DEMO otherwise.

▸

Add a tool’s config + key, start its relay, and its panel flips to live.

FIX

Troubleshooting

Symptom	Fix
running scripts is disabled	`Set-ExecutionPolicy -Scope CurrentUser RemoteSigned`
permission denied: ./aegis-install.sh	`chmod +x aegis-install.sh` then run again
python not found	Install Python 3.11+ (tick “Add to PATH”), or `winget install Python.Python.3.12`	`sudo apt install python3 python3-pip` or `brew install python`
a panel stays on DEMO	Its relay isn’t running, or its config has placeholder values — see the Setup Center.