Skip to main content

DeepSeek Exposure Scan

One command scans a codebase for DeepSeek components — hosted API endpoints, SDKs, model identifiers, dependencies, container pulls, local model files — and writes an evidence report you can hand to the customer or team asking the question.

License: Apache-2.0 Python 3.10+

deepseek-scan is an AI supply-chain transparency tool. It does static, local, read-only scanning: no network calls, no code leaves the machine, zero third-party dependencies.

Why this exists

On 2026-10-20, the U.S. Department of Homeland Security's Exclusion and Removal Order #2026-01 was published in the Federal Register (FR Doc. 2026-21447, docket DHS-2026-0628). The order, issued under the Federal Acquisition Supply Chain Security Act (FASCSA) and signed 2026-07-24, directs federal civilian agencies to stop procuring DeepSeek products and to remove DeepSeek products — including third-party products and services developed using DeepSeek implementations — from their systems. Through FAR 52.204-30, the same obligation flows down to contractors and their suppliers, who are now being asked to show what is inside the software they deliver.

The order does not restrict the general public or private companies using DeepSeek on their own account. It creates a documentation problem for one specific group: vendors who sell into the U.S. federal civilian market and need to find — and show they found — every place DeepSeek appears in their stack.

That is the problem this tool addresses: evidence collection, in the open, with its limits printed on the report.

What it detects

Rules are data, not code — see rules/deepseek.rules.json (rules version 2026.10.22.1). The current set checks for:

Evidence Examples
Hosted API endpoints api.deepseek.com in source and configuration
Credential / config variables DEEPSEEK_API_KEY, DEEPSEEK_API_BASE, DEEPSEEK_MODEL
Model identifiers deepseek-chat, deepseek-reasoner, deepseek-r1, deepseek-v3, deepseek-ai/... hub ids
SDK usage import deepseek, require("deepseek"), JS/Go client references
Dependencies DeepSeek packages in requirements.txt, pyproject.toml, package.json, go.mod, … and in lockfiles (transitive)
Container / deployment DeepSeek images or model pulls (e.g. ollama pull deepseek-r1) in Dockerfile, compose files
Local model artifacts *.safetensors / *.gguf weight files with DeepSeek names; config.json files declaring DeepSeek architectures

Every finding carries the rule id, severity, file:line location and the matched line itself (with anything that looks like a live secret redacted before it can reach a shared report).

Install

From PyPI:

pip install deepseek-scanner

Or from GitHub:

pip install git+https://github.com/dylanXM/deepseek-scanner.git

Or from a checkout:

git clone https://github.com/dylanXM/deepseek-scanner.git
cd deepseek-scanner
pip install .

Requires Python 3.10+. No third-party dependencies.

Quick start

# Human-readable evidence report on stdout
deepseek-scan scan ./my-product

# Save a report / machine-readable JSON
deepseek-scan scan ./my-product --out evidence-report.md
deepseek-scan scan ./my-product --format json --out evidence-report.json

# CI gate: exit 1 if any critical or high finding exists
deepseek-scan scan ./my-product --fail-on high

Example output

Scanning the intentionally dirty sample project in tests/fixtures/positive (full reports: examples/sample-report.md, examples/sample-report.json):

# DeepSeek Exposure Scan - Evidence Report

| Field | Value |
|---|---|
| Files scanned | 9 |
| Total findings | 26 |

## Summary by severity

| Severity | Findings |
|---|---|
| critical | 2 |
| high | 22 |
| medium | 2 |

### Critical

#### DeepSeek hosted API endpoint (DS-001)

- Location: `app.py:8`
- Component: api.deepseek.com (hosted-api-endpoint)
- Evidence type: api_endpoint

    base_url="https://api.deepseek.com",

The JSON report uses an AI-BOM-style shape (component name / type / vendor, evidence, source file), so it can feed inventory tooling:

{
  "rule_id": "DS-001",
  "severity": "critical",
  "component": { "name": "api.deepseek.com", "type": "hosted-api-endpoint", "vendor": "DeepSeek" },
  "evidence": { "type": "api_endpoint", "source_file": "app.py", "line": 8,
                "snippet": "base_url=\"https://api.deepseek.com\"," }
}

GitHub Action

- uses: dylanXM/deepseek-scanner@v0.1.1
  with:
    path: "."
    fail-on: "high"   # turn the scan into a CI gate
    out: "deepseek-exposure-report.md"

A complete example workflow is in examples/workflow.yml. The action is composite rather than Docker-based: the scanner is a zero-dependency Python package, so there is no image to build or pull, and the pinned action ref is the version pin.

Detection limits

This scanner checks a fixed, published set of textual and filename indicators. It detects, when present in the scanned tree: references to DeepSeek-hosted API endpoints in source and configuration; DeepSeek SDK imports and package names; DeepSeek names in dependency manifests and lockfiles (direct and transitive); DeepSeek image or model pulls in container definitions; and first-party model weight files and model configs.

It cannot detect: a model distilled from DeepSeek outputs and shipped under a different name with no textual trace; weight files that were renamed and stripped of identifying metadata; calls routed through a third-party gateway under that gateway's own domains and model names; or any use that leaves no artifact in the scanned tree.

A report with findings is evidence that the listed indicators are present at the listed locations. A report without findings means only that none of the indicators in the current rule set were found in the scanned tree; it is not proof that no DeepSeek-derived component exists in a product. Determinations about obligations under DHS Exclusion and Removal Order #2026-01 or FAR 52.204-30 rest with each organization and its counsel. This tool is an evidence-collection aid, not a legal determination.

Roadmap

  • Phase 2 — weight provenance: integrate the Cisco Model Provenance Kit (planned integration; that project is Apache-2.0) so renamed weight files can be compared against known DeepSeek fingerprints instead of filenames.
  • Rule packs for future exclusion orders: the engine is vendor-neutral; when another lab is named under FASCSA, it should be a new JSON rule file, not a new tool.
  • CycloneDX AI-BOM export alongside the current JSON shape.
  • More manifest formats (conda, Maven, Gradle) and monorepo-friendly path filters.

Contributing

Issues and rule contributions are welcome. The highest-value contribution is a new detection rule: rules are JSON entries in rules/deepseek.rules.json with a pattern, severity, regulatory context and remediation text — plus a positive and negative fixture under tests/fixtures/ proving the rule fires and stays quiet. Run pytest and ruff check src tests before opening a PR.

License

Apache-2.0 — see LICENSE.

This project is an independent open-source tool. It is not affiliated with DeepSeek, the U.S. Department of Homeland Security, or Cisco. Vendor and product names are used only to describe what the rules look for.

Metadata

Release files for deepseek-scanner 0.1.1

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

Source distribution (sdist)

Source distribution for deepseek-scanner 0.1.1
File Size Uploaded Provenance Actions
deepseek_scanner-0.1.1.tar.gz 22.4 kB With provenance Details for deepseek_scanner-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for deepseek-scanner 0.1.1
File Interpreter ABI Platform Actions
deepseek_scanner-0.1.1-py3-none-any.whl Python 3 none any Details for deepseek_scanner-0.1.1-py3-none-any.whl

Total release size: 42.3 kB

Release files / deepseek_scanner-0.1.1.tar.gz

Download URL deepseek_scanner-0.1.1.tar.gz
Size 22.4 kB
Tags Source
SHA-256 checksum
How to use checksums
ed6a4e58d7c91920df440407a2ee49af69153a11c22984d41d022bd59bacbbd2
BLAKE2b-256 checksum
How to use checksums
d82018cb2f9afd1036f0b926b9341458e441ca7d1b55f1a123cb8234e59a9e6e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 28, 2026.

Transparency log

Release files / deepseek_scanner-0.1.1-py3-none-any.whl

Download URL deepseek_scanner-0.1.1-py3-none-any.whl
Size 20.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
73c2042e083f93f29243867c60d224b04beba0fbc549364b5ff80a86d5d0dfbe
BLAKE2b-256 checksum
How to use checksums
abdda86e99a6430274e0a611947e973b6f876c35ceffc76106422f3c898b475a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 28, 2026.

Transparency log

Security for deepseek-scanner 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for deepseek_scanner-0.1.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 28, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files Full provenance

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