How aboutcode-org/vulnerablecode works
VulnerableCode is a Django-backed database and web/API for software-package vulnerabilities, with PURLs as a central package identifier. Its main workflow is to ingest advisory data from public sources, normalize and persist it, improve package/version impact information, then expose vulnerability results through the UI and API. The repository also includes VulnTotal, a CLI and datasource layer for checking packages across vulnerability providers. The tree and README establish these product areas; sampled excerpts confirm runner, pipeline, advisory, and model responsibilities, but not every route or integration detail.
Main entry points: models.py Vulnerability database · advisory.py Advisory persistence · __init__.py Vulnerability providers · tasks.py Run scheduler
Components 19
User access
- Web UI
vulnerabilities/views.py - Vulnerability API
vulnerabilities/api.py
Advisory ingestion
- Run scheduler
vulnerabilities/tasks.py - Pipeline engine
vulnerabilities/pipelines/__init__.py - Source importers
vulnerabilities/importers/apache_tomcat.py - Legacy import runner
vulnerabilities/import_runner.py - Advisory data
vulnerabilities/importer.py
Impact analysis
- Improve runner
vulnerabilities/improve_runner.py - Improvement rules
vulnerabilities/improvers/valid_versions.py - Severity scoring
vulnerabilities/severity_systems.py - OVAL processing
vulnerabilities/lib_oval.py
Data and federation
- Vulnerability database
vulnerabilities/models.py - Advisory persistence
vulnerabilities/pipes/advisory.py - Federated export
vulnerabilities/pipelines/exporters/federate_vulnerabilities.py
VulnTotal lookup
- VulnTotal CLI
vulntotal/vulntotal_cli.py - Vulnerability providers
vulntotal/datasources/__init__.py - VulnerableCode datasource
vulntotal/datasources/vulnerablecode.py - Provider results
vulntotal/validator.py
Other components
- Package user
Connections 18
- Package user → Web UI: queries packages
- Package user → Vulnerability API: requests results
- Web UI → Vulnerability database: reads vulnerability data
- Vulnerability API → Vulnerability database: reads vulnerability data
- Run scheduler → Pipeline engine: dispatches pipeline
vulnerabilities/tasks.py - Run scheduler → Legacy import runner: dispatches legacy run
vulnerabilities/tasks.py - Pipeline engine → Advisory persistence: imports advisories
vulnerabilities/pipelines/__init__.py - Source importers → Advisory data: produces advisory data
vulnerabilities/importers/apache_tomcat.py - Legacy import runner → Advisory data: uses import contract
vulnerabilities/import_runner.py - Advisory persistence → Vulnerability database: writes advisory records
vulnerabilities/pipes/advisory.py - Improve runner → Improvement rules: runs improvement rules
- Improvement rules → Vulnerability database: reads package advisories
vulnerabilities/improvers/valid_versions.py - Advisory persistence → Severity scoring: computes risk score
vulnerabilities/pipes/advisory.py - OVAL processing → Vulnerability database: processes vulnerability data
- Federated export → Vulnerability database: exports vulnerability data
- VulnTotal CLI → Vulnerability providers: dispatches datasource checks
vulntotal/vulntotal_cli.py - Vulnerability providers → VulnerableCode datasource: offers datasource
- Vulnerability providers → Provider results: uses result contract