Skip to main content

Scan dependencies for known vulnerabilities and licenses.

Project description

safety

Downloads CI Status License PyPI Version Python Versions Coverage

[!NOTE] Come and join us at SafetyCLI. We are hiring for various roles.

Table of Contents

Introduction

Safety CLI is a Python dependency vulnerability scanner designed to enhance software supply chain security by detecting packages with known vulnerabilities and malicious packages in local development environments, CI/CD, and production systems. Safety CLI can be deployed in minutes and provides clear, actionable recommendations for remediation of detected vulnerabilities.

Leveraging the industry's most comprehensive database of vulnerabilities and malicious packages, Safety CLI Scanner allows teams to detect vulnerabilities at every stage of the software development lifecycle.

Key Features

  • Versatile, comprehensive dependency security scanning for Python packages.
  • Leverages Safety DB, the most comprehensive vulnerability data available for Python.
  • Clear output with detailed recommendations for vulnerability remediation.
  • Automatically updates requirements files to secure versions of dependencies where available, guided by your project's policy settings.
  • Scanning of individual requirements files and project directories or system-wide scans on developer machines, CI/CD pipelines, and Production systems to detect vulnerable or malicious dependencies.
  • JSON, SBOM, HTML and text output.
  • Easy integration with CI/CD pipelines, including GitHub Actions.
  • Enterprise Ready: Safety CLI can be deployed to large teams with complex project setups with ease, on-premise or as a SaaS product.

Getting Started

GitHub Action

Command Line Interface

1. Installation

  • Install Safety on your development machine.
  • Run pip install safety.

2. Log In or Register

  • Run your first scan using safety scan.
  • If not authenticated, Safety will prompt for account creation or login.
  • Use safety auth to check authentication status.

3. Running Your First Scan

  • Navigate to a project directory and run safety scan.
  • Safety will perform a scan and present results in the Terminal.

Basic Commands

  • safety --help: Access help and display all available commands.
  • safety auth: Start authentication flow or display status.
  • safety scan: Perform a vulnerability scan in the current directory.
  • safety system-scan: Perform a scan across the entire development machine.
  • safety scan --apply-fixes: Update vulnerable dependencies.

Service-Level Agreement (SLA)

We are committed to maintaining a high level of responsiveness and transparency in managing issues reported in our codebases. This SLA outlines our policies and procedures for handling issues to ensure timely resolutions and effective communication with our community.

Detailed Documentation

Full documentation is available at https://docs.safetycli.com.

Included in the documentation are the following key topics:

Safety CLI 3

Vulnerability Remediation

Integration

Administration

Output

Miscellaneous

System status is available at https://status.safetycli.com

Further support is available by emailing support@safetycli.com.

License

Safety is released under the MIT License.

Upon creating an account, a 7-day free trial of our Team plan is offered to new users, after which they will be downgraded to our Free plan. This plan is limited to a single user and is not recommended for commercial purposes.

Our paid plans for commercial use begin at just $25 per seat per month and allow scans to be performed using our full vulnerability database, complete with 3x more tracked vulnerabilities and malicious packages than our free plan and other providers. To learn more about our Team and Enterprise plans, please visit https://safetycli.com/resources/plans or email sales@safetycli.com.

Supported Python Versions

Safety CLI 3 supports Python versions >=3.7. Further details on supported versions, as well as options to run Safety CLI on versions <3.7 using a Docker image are available in our Documentation Hub.

We maintain a policy of supporting all maintained and secure versions of Python, plus one minor version below the oldest maintained and secure version. Details on Python versions that meet these criteria can be found here: https://endoflife.date/python.

Resources

Project details


Release history Release notifications | RSS feed

This version

3.6.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

safety-3.6.0.tar.gz (291.1 kB view details)

Uploaded Source

Built Distribution

safety-3.6.0-py3-none-any.whl (285.3 kB view details)

Uploaded Python 3

File details

Details for the file safety-3.6.0.tar.gz.

File metadata

  • Download URL: safety-3.6.0.tar.gz
  • Upload date:
  • Size: 291.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for safety-3.6.0.tar.gz
Algorithm Hash digest
SHA256 a820f827699f83d3d5c2faab24c0ac4d094911931503180847d97942c0a6f7e3
MD5 9c0bc4bb05f1aa0a6299c5d2e6bd5140
BLAKE2b-256 04c0832778e8f53e922f1939455cab4149339ca66c4f06e3c67599511d857279

See more details on using hashes here.

Provenance

The following attestation bundles were made for safety-3.6.0.tar.gz:

Publisher: cd.yml on pyupio/safety

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file safety-3.6.0-py3-none-any.whl.

File metadata

  • Download URL: safety-3.6.0-py3-none-any.whl
  • Upload date:
  • Size: 285.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for safety-3.6.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9cddbfd7a578b35e4d29df4fb6e3808425ed792a09d81400a5b7f4b4535ef666
MD5 feb50436db2a4dbad2d8ab8946f27f9e
BLAKE2b-256 45127f7dfcd6975011e73573ac8acdd301b29f976d27e6149d8448051ad62189

See more details on using hashes here.

Provenance

The following attestation bundles were made for safety-3.6.0-py3-none-any.whl:

Publisher: cd.yml on pyupio/safety

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page