pysentra

Local-first security scanner for web applications (DAST) and universal local codebases (SAST + Secrets + Dependencies), featuring a zero-login live vulnerability dashboard.

Authorization required — Use pysentra only against systems and codebases you own or have explicit permission to assess. It rate-limits requests, avoids destructive checks, and requires an authorization confirmation before scanning.

Privacy

pysentra makes no external network calls other than to the target you specify and OSV.dev for dependency vulnerability checks. No telemetry, no analytics, no data leaves your machine. All scan reports, logs, and artifacts are stored locally in the pysentra-reports/ directory.

Install

pip install pysentra

For local development, use pip install -e ".[dev]".

Quickstart

1. Scan local code (Universal static & dependency scan)

Scan any repository or folder locally on any device without running the application:

cd ~/any/project
pysentra scan .

Or point to any local directory or file:

pysentra scan /path/to/repo

pysentra automatically inspects files for hardcoded secrets, insecure framework configs, vulnerable dependencies (via OSV.dev), exposed sensitive files, and potential code injection patterns.

2. Scan a running web app (DAST)

Run the intentionally vulnerable demo target in one terminal:

cd demo-vulnerable-app
pip install -r requirements.txt
python app.py

Then scan it from the project root:

pysentra scan http://localhost:5000 --i-am-authorized --target-is-test-app

Both modes generate report.json and a printable report.html under pysentra-reports/<timestamp>/ and start the live dashboard at http://127.0.0.1:8765 (no login or auth required).

Dashboard

The dashboard provides severity cards, a findings chart, interactive filters, expandable evidence/PoCs, and JSON/HTML export links. It binds strictly to 127.0.0.1 and requires zero credentials.

CLI Reference

Architecture

1. Local Code Scanner (code_checks): Language-agnostic inspection covering Secrets, Dependencies (OSV.dev), Insecure Configs, Sensitive File Exposure, and Static Code Injection.
2. Web Application Scanner (scanner/): Rate-limited, audited assessment covering Auth, AuthZ, Input Validation, API Security, Client-Side Controls, TLS/HSTS, Storage & Privacy, and CORS.
3. Dashboard & Reporting (dashboard/, report/): Zero-login local web UI and JSON/HTML report generation.

Troubleshooting

"pip install --upgrade pysentra" doesn't show the latest version

Right after a new release, PyPI's CDN can take a minute or two to propagate, and pip may also be using a locally cached index response. If pysentra --version doesn't show the version you expect:

pip install --no-cache-dir --upgrade pysentra

This is expected shortly after a release and is not a bug — retry normally once a minute or two has passed.

Contributing

See CONTRIBUTING.md. Do not add checks that could be destructive, credential-brute-force targets, or bypass safeguards.