depwarden-cli
DepWarden CLI — scan your pip, Poetry, or Pipenv project for supply-chain vulnerabilities.
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.
Links
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)
| File | Size | Uploaded | |
|---|---|---|---|
| depwarden_cli-1.1.0.tar.gz | 10.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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
|