Installation¶

By the end of this page TrustSight is installed and trustsight --help runs. It requires Arch Linux, Python 3.11 or later, and git (for cloning AUR repositories during analysis).

Build the repository PKGBUILD (recommended)¶

The PKGBUILD pins one released version, so check out the release tag it names rather than the moving master branch:

git clone --depth 1 --branch "$(git ls-remote --tags --refs --sort=-v:refname \
  https://github.com/emiliano-go/trustsight.git 'v*' | head -1 | cut -d/ -f3)" \
  https://github.com/emiliano-go/trustsight.git
cd trustsight/packaging/aur
makepkg -si

To build the checkout you just cloned, with no second download of the same sources from GitHub, use the local recipe instead. It derives pkgver from git describe and builds the tree in place:

cd trustsight/packaging/local
makepkg -si

Before installing a release, you can confirm the asset matches the tag it claims to describe:

python scripts/build_release_tarball.py --rev v<version> --check <sha256>

The recorded <sha256> is in packaging/aur/PKGBUILD.

The PKGBUILD runs the packaged test suite during build, excluding tests/test_fetcher.py and tests/test_rebaseline.py because they require network and corpus fixtures unavailable in a clean package build. makepkg -si pulls in the dependencies (pygit2, tldextract, rich, typer, cryptography) as proper system packages. The result is tracked by pacman, so it upgrades and uninstalls like anything else on the system.

Build the PKGBUILD in this repository, as above. PyPI distributions are for isolated virtual environments, not for installation into Arch's system Python: installing with pip is blocked by the system Python's externally-managed-environment protection, and forcing it with --break-system-packages risks conflicting with pacman-managed files. For an isolated environment, install the PyPI distribution with python -m venv .venv && .venv/bin/pip install trustsight.

For a development checkout with the test dependencies, use a virtualenv instead (see development setup).

Install from the AUR¶

The trustsight package on the AUR is maintained by this project, but it is an AUR package like any other: it gets no special trust, so review its PKGBUILD before installing, exactly as you would with any other.

git clone https://aur.archlinux.org/trustsight.git
cd trustsight
makepkg -si

Or with an AUR helper: yay -S trustsight.

Verify the installation¶

trustsight --help

You should see a list of available commands: review, inspect, history, list, status, seed-db, baseline, full-aur, import-baseline, config, db, override, lint-rules, lint, corpus, ioc, seed, explain, report, forget.

Check your configuration:

trustsight config show

Common failures¶

Next: Quickstart, run your first review.