Skip to main content

filegoblin

Converts PDFs (including scans and math), Word, PowerPoint, Excel, HTML and web pages, EPUB, email, notebooks, subtitles and audio into clean Markdown for LLMs. It's a single native binary with no Python dependencies. This package installs it and puts filegoblin on your PATH.

pip install filegoblin             # converter, without the PDF vision models
pip install "filegoblin[models]"   # plus the PDF vision models (~510 MB)

The models extra adds the bundled PDF vision models:

  • PP-DocLayoutV3 for layout and reading order
  • pix2text MFR for formulas, written out as LaTeX
  • Table Transformer for tables
  • PP-OCRv6 for OCR on scanned pages

--vision smart, the default, sends the pages that need them through the models: scans, math, tables, columns and figures. Without the models, filegoblin uses its fast geometric converter, plus Apple Vision OCR on macOS.

The models come from PyPI like any other package, so they install wherever pip install works, including behind a corporate package mirror. You can also add them later with filegoblin --install-models, which downloads them from the GitHub release. filegoblin --models-status shows which models it finds.

filegoblin report.pdf > report.md
filegoblin https://example.com/article
filegoblin --mcp        # MCP server for Claude and other agents

Documentation: https://github.com/funkyfunc/filegoblin

Metadata

Release files for filegoblin 1.15.0

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

Built distributions (wheels)

Table of built distributions (wheels) for filegoblin 1.15.0
File
filegoblin-1.15.0-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details
filegoblin-1.15.0-py3-none-manylinux_2_35_x86_64.whl Python 3 none Linux glibc 2.35+ x86-64 Details
filegoblin-1.15.0-py3-none-manylinux_2_35_aarch64.whl Python 3 none Linux glibc 2.35+ ARM64 Details
filegoblin-1.15.0-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details
filegoblin-1.15.0-py3-none-macosx_10_12_x86_64.whl Python 3 none macOS 10.12+ x86-64 Details

Total release size: 124.9 MB

Release files / filegoblin-1.15.0-py3-none-win_amd64.whl

Download URL filegoblin-1.15.0-py3-none-win_amd64.whl
Size 24.3 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
d9683d6fa5072c0881bea7ddb189408f344774fac4c7b606537f0282e789498e
BLAKE2b-256 checksum
How to use checksums
bfbca084e828f753a0935fe6185bcd624ade19b9f9e52795d09962dc62efa8f6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 17, 2026.

Transparency log

Release files / filegoblin-1.15.0-py3-none-manylinux_2_35_x86_64.whl

Download URL filegoblin-1.15.0-py3-none-manylinux_2_35_x86_64.whl
Size 26.6 MB
Tags Linux glibc 2.35+ x86-64 Python 3
SHA-256 checksum
How to use checksums
acbbd8fc963fed07a363dee286b6bba414c0d5095102d35793a209ecdee20da1
BLAKE2b-256 checksum
How to use checksums
14033a9ad9f49bac1b710cf50053f1e9cde0b5fada864cc10130cd52c909d421
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 17, 2026.

Transparency log

Release files / filegoblin-1.15.0-py3-none-manylinux_2_35_aarch64.whl

Download URL filegoblin-1.15.0-py3-none-manylinux_2_35_aarch64.whl
Size 25.2 MB
Tags Linux glibc 2.35+ ARM64 Python 3
SHA-256 checksum
How to use checksums
7e1451e687aa3c5d00a8da94635dd4e93ddf679ad0e8bf2d806d4757c8a6d389
BLAKE2b-256 checksum
How to use checksums
30d861a3ca0501ced772caf9ff2a6ed39ab59b94a263edd43dfb21d2fbe2f8b3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 17, 2026.

Transparency log

Release files / filegoblin-1.15.0-py3-none-macosx_11_0_arm64.whl

Download URL filegoblin-1.15.0-py3-none-macosx_11_0_arm64.whl
Size 23.2 MB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
a6f4f6254c168cb974df39f341b12ab152e6719723ff71303918f30319929f8d
BLAKE2b-256 checksum
How to use checksums
b14b6f3d5cce64dc0bacd52417598a9c42203fe3cd6720376d3613c2169fa028
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 17, 2026.

Transparency log

Release files / filegoblin-1.15.0-py3-none-macosx_10_12_x86_64.whl

Download URL filegoblin-1.15.0-py3-none-macosx_10_12_x86_64.whl
Size 25.5 MB
Tags Python 3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
3ae6af3319dd6138481bfc35f7029ffec56fffb816c0ca3cd8b80bd060bccbaa
BLAKE2b-256 checksum
How to use checksums
9b3fb93cb7e64bc2bd6989b821efad8d8c96c70ebf734ed20bfa066f1f006a4d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 17, 2026.

Transparency log

Security for filegoblin 1.15.0

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

All 5 files in this release have been uploaded with provenance metadata.

Select from 5 files

Attestation for filegoblin-1.15.0-py3-none-win_amd64.whl

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 17, 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

1.15.0 This release

5 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