whatisgithub

What is scrapemychats?

conradqh/scrapemychats — explained in plain English

Analysis updated 2026-07-25

62PythonAudience · generalComplexity · 2/5Setup · moderate

In one sentence

A tool that downloads all your ChatGPT conversations, including files and images, to your computer and builds a searchable offline archive you can browse without internet.

Mindmap

mindmap
  root((repo))
    What it does
      Copies ChatGPT chats
      Builds offline archive
      Resumable downloads
    Outputs
      JSON raw data
      Markdown transcripts
      Searchable HTML viewer
    Use cases
      Leaving Team account
      Personal backup
      Search old chats
    Tech stack
      Python
      Chrome browser
      Local files only
    Audience
      Non-technical users
      Workplace departures
      Privacy conscious

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Back up all your ChatGPT conversations before leaving a workplace Team account.

USE CASE 2

Create a searchable offline archive of your chats that you can browse from a USB stick.

USE CASE 3

Export conversation history from a personal ChatGPT account for long-term safekeeping.

What is it built with?

PythonChromeJSONMarkdownHTML

How does it compare?

conradqh/scrapemychatsamap-ml/blockpiloternie-research/nava
Stars626262
LanguagePythonPythonPython
Setup difficultymoderatemoderatehard
Complexity2/53/55/5
Audiencegeneralresearcherresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Python installed locally and a Chrome browser with an active ChatGPT login session, large accounts may take hours to fully export.

So what is it?

scrapemychats solves a specific problem: when someone leaves a ChatGPT business or Team account, there is often no built-in way to export conversation history. The personal account "Export data" button is simply missing from these workplace plans. This tool copies every conversation, including text and attached files, onto your own computer and then builds a searchable offline archive you can keep indefinitely. It also works on personal accounts. The tool operates by opening a real Chrome browser window on your machine using your existing ChatGPT login session. It never sees your password, and no data is sent anywhere except to chatgpt.com itself. Everything stays local. The export process runs unattended for a few hours on large accounts, which is intentional, and if your computer sleeps or you interrupt it, you just run the same command again and it picks up where it left off. The end result is a folder containing a separate subfolder for each conversation. Inside each one you get the complete raw data in JSON format, a readable Markdown transcript, and any attached files or images. A manifest CSV file tracks the status of every chat, and an errors log records anything that could not be fetched. The centerpiece is a single self-contained HTML file called viewer.html that lets you search and browse everything at once. That viewer requires no server, no internet connection, and no additional software. You can run it from a USB stick. It offers instant full-text search across all conversations with highlighted matches, optional categorization into groups like Personal and Work based on keywords you define, inline image thumbnails, and keyboard navigation. You can edit a categories file to match the structure of your own life and re-run the build step to re-file everything. The README is unusually thorough for non-technical users, providing step-by-step instructions for Windows and Mac with about ten steps each, and even suggesting you paste a prompt into a chatbot to get walked through the process one instruction at a time. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Help me install Python and run scrapemychats on my Mac to download all my ChatGPT conversations step by step.
Prompt 2
I ran scrapemychats but my computer went to sleep partway through. How do I resume the export without losing progress?
Prompt 3
Help me edit the categories file in scrapemychats so my chats are sorted into Personal, Work, and Research groups based on keywords.
Prompt 4
Walk me through opening viewer.html from scrapemychats on a USB stick and searching across all my exported conversations.

Frequently asked questions

What is scrapemychats?

A tool that downloads all your ChatGPT conversations, including files and images, to your computer and builds a searchable offline archive you can browse without internet.

What language is scrapemychats written in?

Mainly Python. The stack also includes Python, Chrome, JSON.

How hard is scrapemychats to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is scrapemychats for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.