Argus

Argus is a test tracking system for automated pipelines. It helps teams inspect test runs, compare results across runs, track events and failures, and understand resource usage for long-running test infrastructure.

Quick Links

Full CLI guide: cli/README.md
REST API usage: docs/api_usage.md
Local development setup: docs/dev-setup.md
Production deployment: docs/deployment.md

Install the CLI

Download the latest CLI release into ~/.local/bin:

Linux amd64

VERSION=$(curl -sL https://api.github.com/repos/scylladb/argus/releases | grep -oP '"tag_name":\s*"cli/v\K[^"]+' | head -1)
mkdir -p ~/.local/bin
curl -sL "https://github.com/scylladb/argus/releases/download/cli/v${VERSION}/argus_${VERSION}_linux_amd64.tar.gz" | tar xz -C ~/.local/bin argus
export PATH="$HOME/.local/bin:$PATH"

macOS amd64

VERSION=$(curl -sL https://api.github.com/repos/scylladb/argus/releases | grep -oP '"tag_name":\s*"cli/v\K[^"]+' | head -1)
mkdir -p ~/.local/bin
curl -sL "https://github.com/scylladb/argus/releases/download/cli/v${VERSION}/argus_${VERSION}_macOS_amd64.tar.gz" | tar xz -C ~/.local/bin argus
export PATH="$HOME/.local/bin:$PATH"

Verify the install:

argus version

First Successful Command

Authenticate against the default production Argus instance:

argus auth

This opens a browser-based login flow when needed and stores credentials for later commands.

If you are running in CI, on a server, or against a local instance, use the auth mode documented in cli/README.md.

Use the CLI

Typical next commands:

argus config list
argus auth logout

For authentication modes, Cloudflare behavior, configuration, and command usage, see cli/README.md.

Use the API

Generate an API token from your Argus profile page, then call the API with:

curl --request GET \
  --url https://argus.scylladb.com/api/v1/client/driver_matrix/test_report?buildId=example/driver-matrix/test \
  --header "Authorization: token <YOUR_TOKEN>"

Full endpoint details and payload examples live in docs/api_usage.md.

Local Development

For local setup, dependencies, ScyllaDB, seed data, and daily workflow, see docs/dev-setup.md.

Production Deployment

For source-based production installation, nginx, systemd, and logging setup, see docs/deployment.md.

Contributing

Review the Repository Guidelines for project structure, tooling expectations, and pull request practices before submitting changes.

Every change goes through the development flow of the qatools-sdlc plugin: intent, spec or rca, plan, code, review. Install the plugin once in Claude Code:

/plugin marketplace add git@github.com:scylladb/qatools.git
/plugin install qatools-sdlc@qatools

CLAUDE.md names the skills, and tasks/README.md describes the task artifacts.

Metadata

Release files for argus-alm 0.16.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for argus-alm 0.16.5
File	Size	Uploaded
argus_alm-0.16.5.tar.gz	2.4 MB	Sep 28, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for argus-alm 0.16.5
File	Interpreter	ABI	Platform	Reset
argus_alm-0.16.5-py3-none-any.whl 51.3 kB Sep 28, 2026	Python 3	none	any	Details

Total release size: 2.5 MB

Release files / argus_alm-0.16.5.tar.gz

Download URL	argus_alm-0.16.5.tar.gz
Size	2.4 MB
Tags	Source
SHA-256 checksum How to use checksums	`02708bb7d5dbfd3e37919e0f207a432f7c79979c4ebda5747be1f4ffeef6caa6`
BLAKE2b-256 checksum How to use checksums	`66c922819f601ab98efb67880930a30c01d91b411850bb114484d7a94b335706`
Upload date	Sep 28, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/scylladb/argus
Publishing commit: github.com/scylladb/argus/tree/9cbfb1f4657151f9ea55b8f77ea42346e79e83cf

Workflow

Publishing configuration: github.com/scylladb/argus/blob/9cbfb1f4657151f9ea55b8f77ea42346e79e83cf/.github/workflows/release.yml
Publishing logs: github.com/scylladb/argus/actions/runs/36416146260/attempts/1

Artifact

Subject: argus_alm-0.16.5.tar.gz
SHA-256 checksum: 02708bb7d5dbfd3e37919e0f207a432f7c79979c4ebda5747be1f4ffeef6caa6 Verifying attestations

Release files / argus_alm-0.16.5-py3-none-any.whl

Download URL	argus_alm-0.16.5-py3-none-any.whl
Size	51.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`b8759b3ea13fc51df2d9ab07f0f7f9789172d94ca8699defe9b268035b7f5410`
BLAKE2b-256 checksum How to use checksums	`dbca9799cba90cc1a37d13cb2858c50ddc6d39e1b9137d1e92ec6589ef18f8d6`
Upload date	Sep 28, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/scylladb/argus
Publishing commit: github.com/scylladb/argus/tree/9cbfb1f4657151f9ea55b8f77ea42346e79e83cf

Workflow

Publishing configuration: github.com/scylladb/argus/blob/9cbfb1f4657151f9ea55b8f77ea42346e79e83cf/.github/workflows/release.yml
Publishing logs: github.com/scylladb/argus/actions/runs/36416146260/attempts/1

Artifact

Subject: argus_alm-0.16.5-py3-none-any.whl
SHA-256 checksum: b8759b3ea13fc51df2d9ab07f0f7f9789172d94ca8699defe9b268035b7f5410 Verifying attestations