filevet

Self-hosted, open-source scanner that checks the files finance teams receive for security risks before anyone opens or ingests them.

Why

Fintechs and finance teams take in files from outside every day: invoices, bank statements, KYC documents, payment files. Any of them can carry malware, exploit the parser that reads it, or hide instructions meant for an AI system further down the line. Commercial scanners are closed and expensive, and the open-source ones don't understand financial formats like ISO 20022. filevet runs several independent analyzers over a file and returns one report you can act on.

Status

Quickstart

These commands will work from v0.1.0.

pipx install filevet
# or
uv tool install filevet

filevet scan statement.pdf

With Docker, without network access and with the file mounted read-only:

docker run --rm --network none --read-only --tmpfs /tmp -v "$PWD:/in:ro" ghcr.io/pablodt00/filevet scan /in/statement.pdf

Example

filevet scan invoice.pdf

Trimmed output from a file named invoice.pdf that's really a Windows executable (the format may still change):

{
  "filevet_version": "0.0.2",
  "artifacts": [
    {
      "id": "1bf01f46-66b9-4b57-a40c-031d8d71615f",
      "name": "invoice.pdf",
      "sha256": "9f2c…e41a",
      "declared_type": "pdf",
      "detected_type": "pe",
      "depth": 0
    }
  ],
  "findings": [
    {
      "rule_id": "basic.type_mismatch",
      "title": "File content does not match its extension",
      "severity": "critical",
      "confidence": 1.0,
      "evidence": "invoice.pdf",
      "references": ["https://cwe.mitre.org/data/definitions/434.html"],
      "analyzer": "basic.type_mismatch/0.1.0"
    }
  ],
  "summary": { "critical": 1, "high": 1, "medium": 0, "low": 0, "info": 0 },
  "verdict": "block"
}

--format table prints the same report as a table for people. The full report format is in docs/schema/report.schema.json, and filevet schema prints it too.

Other commands: filevet analyzers lists the registered analyzers, and filevet version prints the version.

Exit codes

CI jobs can act on the exit code of filevet scan without parsing the report.

What it checks

Planned for v0.1:

Limitations

• filevet never declares a file safe. It reports what it checked and what it found, and no scanner catches everything.
• It doesn't replace antivirus or EDR, email security, or human review of high-value payments.
• v0.1 doesn't detect document tampering or inconsistent financial data (planned for v0.2), or content aimed at AI pipelines (planned for v0.3).
• It doesn't analyze network traffic, attribute malware to families, or store scanned files.

The full scope is in docs/SCOPE.md.

Roadmap

Work is split into phases, each tracked as a milestone: foundations, MVP (v0.1), integrity checks (v0.2), platform features such as a REST API and policy engine (v0.3), and hardening for v1.0.

Contributing

Start with CONTRIBUTING.md. Everyone taking part is expected to follow the Code of Conduct.

Security

Report vulnerabilities privately, as described in SECURITY.md. Please don't open public issues for them.

License

Apache License 2.0. See also NOTICE.