Skip to content

Install

Source access

AIT is not offered as a public packaged download. These commands prepare an authorized collaborator's source checkout. They are not end-user release instructions.

AIT platform

From a source checkout:

python3 -m pip install -e ".[test]"
ait doctor --profile core

Direct interception is ready immediately. AIT creates a private default workspace, so the primary lab and Cockpit need no ait init:

ait lab start --exercise delegated-a2a-message

For Parquet, DuckDB, plots, notebooks, and publication exports:

python3 -m pip install -e ".[research,test]"

Initialize a named workspace only when you want engagement records, findings, or research artifacts. AIT will not silently place those artifacts in an arbitrary current directory.

ait init ./assessment --name "Authorized assessment"
cd ./assessment
ait workspace show

AIT SDK

Plugin authors can install the independent ait-sdk package without installing the platform server, database, CLI, transports, or peer tools:

python3 -m pip install ./sdk

The Python package is ait_sdk, requires Python 3.11 or newer, and depends only on Pydantic 2 at runtime. It provides strict plugin and evidence contracts, runtime-checkable plugin interfaces, compatibility gates, canonical schemas, and bounded ait.plugin-jsonl/v1 helpers. It does not execute or sandbox plugins.

Local service boundary

ait server start is a local workstation service. It accepts loopback listeners only and creates a random bearer token under the private workspace state.

ait server start --listen 127.0.0.1:8790

The optional Compose profile is also a loopback workstation deployment; native installation is the most portable path.

Seam

cd agentic-redteam/seam
go build ./cmd/seam
go test -count=1 ./...
bash scripts/smoke-release.sh

Assay

cd agentic-redteam/assay
python3 -m pip install -e ".[test]"
python3 -m pytest -q

Assay expects a running Seam local API when executing cases.

meshmapper

cd agentic-redteam/meshmapper
python3 -m pip install -e ".[test]"
python3 -m pytest -q

meshmapper reads Seam transcripts and other saved artifacts, then writes graphs and path hypotheses.

Documentation

python3 -m pip install -r docs/requirements.txt
mkdocs serve

For CI-style validation:

mkdocs build --strict --site-dir /tmp/new_aitm_docs_check

The repository workflow stages an explicit allowlist before building the public site. Publication and research material are excluded by default. Do not bypass that boundary with a manual Pages deployment.