Getting Started

Installation

Install Talos on macOS, Linux, or Windows.

Talos is distributed as a Python package on PyPI. It has no native dependencies and runs on any platform with Python 3.10+.

From PyPI (recommended)

shell

❯ pip install talos-redteam

If you'd rather keep Talos out of your project's virtualenv, install it with pipx.

shell

❯ pipx install talos-redteam
❯ talos-scan --help

Contributors and design partners on the private beta can install directly from the git repository.

shell

❯ git clone https://github.com/talos-security/talos.git
❯ cd talos && pip install -e '.[dev]'
❯ pytest

A slim Docker image is published for use in CI where you cannot install Python packages directly.

shell

❯ docker run --rm -v $PWD/reports:/reports \
  ghcr.io/talos-security/talos:0.1.0 \
  --target https://staging.example.com/agent \
  --adapter native

shell

❯ talos-scan --version
talos-redteam 0.1.0
❯ talos-scan doctor
✓ Python 3.11.7 — OK
✓ Network egress   — OK
✓ Report directory — ./reports (writable)

Note

Corporate proxies can block the outbound calls Talos makes when generating attacks. Configure HTTPS_PROXY in your shell before running the CLI.