Skip to main content

depwarden-cli

DepWarden CLI — scan your pip, Poetry, or Pipenv project for supply-chain vulnerabilities.

PyPI License: MIT Website

Quick start

pip install depwarden-cli

APP_API_URL=https://depwarden.in \
APP_API_KEY=DEMO \
depwarden

Use DEMO as the API key for three free full-fidelity scans. Get a permanent key at depwarden.in.

Installation

pip install depwarden-cli

Zero dependencies beyond the Python standard library — nothing else lands in your environment.

Usage

depwarden [options]

The CLI auto-detects your lockfile (requirements.txt, poetry.lock, Pipfile.lock, uv.lock, then pyproject.toml), in that order.

Options

Flag Default Description
--api-url <url> APP_API_URL env DepWarden server base URL
--api-key <key> APP_API_KEY env API key (dw_live_… or DEMO)
--formats <list> html Comma-separated report formats: html,pdf,xlsx,csv
--report-types <list> risk-summary Report types to download
--out <dir> depwarden-reports Directory to write downloaded reports
--fail-on-error <bool> true Fail the process when gate result is fail
--manifest-file <path> (auto-detect) Path to a specific lockfile
--project <name> conformance-fixture Project name sent to the API
--timeout <seconds> 30 Per-request timeout
--retries <n> 3 Max retries on transient network errors
--cache-dir <dir> .depwarden-cache Offline verdict cache directory
--cache-grace <hours> 24 How long a cached verdict stays valid when offline
--verify-signature false Verify the returned verdict's signature server-side
--verbose / -v false Verbose retry and detection output

Environment variables

Variable Description
APP_API_URL Base URL of your DepWarden instance
APP_API_KEY API key — use DEMO for free evaluation

HTTP_PROXY / HTTPS_PROXY / NO_PROXY are honoured automatically (standard urllib behaviour) — no extra configuration needed behind a corporate proxy.

Exit codes

Code Meaning
0 Clean scan, or gate failed with --fail-on-error false
1 Gate result is fail (build should fail)
2 Configuration / IO / network error with no cached verdict
3 Invalid or revoked API key
4 Quota exceeded or demo allowance exhausted

GitHub Actions

- name: DepWarden SCA scan
  env:
    APP_API_URL: https://depwarden.in
    APP_API_KEY: ${{ secrets.APP_API_KEY }}
  run: |
    pip install depwarden-cli
    depwarden --formats html --out reports

Download reports

depwarden --formats html,pdf,xlsx --out ./security-reports

Offline mode

The CLI caches the last successful verdict in .depwarden-cache/. If the server is unreachable, it falls back to the cached result for up to 24 hours (configurable via --cache-grace).

💸 Enjoying this? Your wallet has feelings too.

The free tier is real — no account, no credit card, no sighing. But if you've been meaning to set up proper build gating, PDF reports your manager can pretend to read, and an audit trail for the one time a log4shell happens on your watch…

Upgrade at depwarden.in/pricing →

Plans start at a price that's genuinely less than your last debugging session cost in lost time. Use DEMO as your API key for three full-fidelity test drives before committing.

License

MIT — see LICENSE.

Metadata

Release files for depwarden-cli 1.1.0

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

Source distribution (sdist)

Source distribution for depwarden-cli 1.1.0
File Size Uploaded
depwarden_cli-1.1.0.tar.gz 10.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for depwarden-cli 1.1.0
File Interpreter ABI Platform
depwarden_cli-1.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 21.0 kB

Release files / depwarden_cli-1.1.0.tar.gz

Download URL depwarden_cli-1.1.0.tar.gz
Size 10.2 kB
Tags Source
SHA-256 checksum
How to use checksums
9297c8735c63efce801d2d66003bc1ce9e387fc18f8a8e158bd60a7bff3731fe
BLAKE2b-256 checksum
How to use checksums
81064dabafa277405e71bb242a6d49b332765c438253d6f4072fa99881d530f5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.4

Release files / depwarden_cli-1.1.0-py3-none-any.whl

Download URL depwarden_cli-1.1.0-py3-none-any.whl
Size 10.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9cb8c5e9e3cd05e072ffe90d37c8e96c67b69321e0560a6c330e104796945c3c
BLAKE2b-256 checksum
How to use checksums
e46ae89ac9750d758a8522b692b24447ce69ce7816afa7293a762a468ff2117b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.4

Release history Release notifications | RSS feed

This release

1.1.0 This release

2 release files

1.0.0

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page