Dashboard
On this page
Setup

Installation

Supported platforms, pip, pipx, npm, upgrades, verification, and removal.

Aevrin supports Python 3.10 or newer on macOS, Linux, and Windows. Install it from PyPI with pip or pipx, or from npm with Node.js 18 or newer.

Choose a package manager

pipx install aevrin

Recommended for Python-based global installation because dependencies stay isolated.

Install by platform

brew install pipx
pipx ensurepath
pipx install aevrin

Restart the shell after ensurepath, then verify the installed command:

aevrin --version
aevrin --help

Scanner prerequisites

Scanning runs one version-pinned engine image in a container, so Docker is required - not recommended. Install Docker Desktop or a compatible Docker Engine, start it before scanning, and allocate at least 4 GB of memory. Windows must use Linux containers and allow bind mounts from its temporary directory. Scanning also needs outbound HTTPS, because resolving a server means fetching its package.

There is no non-Docker fallback and no lookup of scanner programs on your PATH. Scanning an MCP server means starting it, which executes code published by someone else, so an unavailable sandbox is an unavailable scan rather than a scan performed without one.

If you would rather not run Docker locally, --remote uploads a local folder's source and scans it on Aevrin's servers instead, so nothing runs on this machine. It is only valid for a local path; a GitHub URL or a live server is already reachable from Aevrin, so start that scan from the dashboard.

aevrin scan ./my-mcp-server --remote

Where a scan could not establish something, Aevrin says so rather than scoring the gap as clean: a stage that ran with something missing is marked PARTIAL COVERAGE, and a scan where a required stage could not run at all is SCAN INCOMPLETE and exits 3.

Upgrade, repair, or remove

pipx upgrade aevrin
aevrin --version

Use pipx reinstall aevrin to repair an installation. To remove everything cleanly, run aevrin logout, then pipx uninstall aevrin.

For pip, repair with python3 -m pip install --upgrade --force-reinstall --no-cache-dir aevrin. For npm, upgrade or repair with npm install --global aevrin@latest and remove with npm uninstall --global aevrin.