epstein-files 1.0.4

Tools for working with the Jeffrey Epstein documents released in November 2025.

I Made Epstein's Text Messages Great Again

• I Made Epstein's Text Messages Great Again (And You Should Read Them) post on Substack
• The Epstein text messages (and some of the emails along with summary information) generated by this code can be viewed here.
• All of His Emails along with descriptions of the 496 files that were neither emails nor text messages can be read at another page also generated by this code.
• Word counts for the communications are here.
• Metadata containing what I have figured out about who sent or received the communications in a given file (and a brief explanation for how I figured it out for each file) is deployed here
• Configuration variables assigning specific HOUSE_OVERSIGHT_XXXXXX.txt file IDs (the 111111 part) as being emails to or from particular people based on various research and contributions can be found in constants.py. Everything in constants.py appears in the JSON metadata linked above.

Usage

1. Requires you have a local copy of OCR text from the House Oversight document dump in a directory /path/to/epstein/ocr_txt_files. You can download them from the Congressional Google Drive folder.
2. Dependencies are in pyproject.toml. Use poetry install for easiest time installing. pip install . may or may not work.

You need to set the DOCS_DIR environment variable with the path to the folder of files you just downloaded when running. You can either create a .env file modeled on .env.example (which will set it permanently) or you can run with:

# Generate color highlighted texts/emails/other files
DOCS_DIR=/path/to/epstein/ocr_txt_files epstein_generate

# Search
DOCS_DIR=/path/to/epstein/ocr_txt_files epstein_search Bannon

# Show a color highlighted file
DOCS_DIR=/path/to/epstein/ocr_txt_files epstein_show 030999
# This also works
DOCS_DIR=/path/to/epstein/ocr_txt_files epstein_show HOUSE_OVERSIGHT_030999

Run epstein_generate --help for command line option assistance. The first time you run anything it will take a few minutes to fix all the data, attribute the redacted emails, etc. Once you've run things once you can run the epstein_generate --pickled to load the cached fixed up data and things will be quick.

As A Library

from epstein_files.epstein_files import EpsteinFiles
epstein_files = EpsteinFiles.get_files()

# All files
for document in epstein_files.all_documents():
    do_stuff()

# Emails
for email in epstein_files.emails:
    do_stuff()

# iMessage Logs
for imessage_log in epstein_files.imessage_logs:
    do_stuff()

# Other Files
for document in epstein_files.other_files:
    do_stuff()