A script to effortlessly extract your entire ChatGPT data export from JSON files to nicely-formatted markdown files.
Convert your ChatGPT history into well-formatted Markdown files. Additionally, visualize your data with word clouds ๐กโ๏ธ, view your prompt history graphs ๐, and access all your custom instructions ๐ค in a single location.
See examples here.
Ensure you have Python and Git installed. If not:
.zip
file.Open a program called "terminal" or "command prompt".
Type (and hit enter after each line):
git clone https://github.com/mohamed-chs/chatgpt-history-export-to-md.git
cd chatgpt-history-export-to-md
This will copy this GitHub repository on your computer, and navigate to the root directory.
Type (and hit enter):
python setup_env.py
This will create a virtual environment and install the necessary python libraries.
On Linux or MacOS:
source .venv/bin/activate
On Windows:
Using Command Prompt (cmd.exe
):
.venv\Scripts\activate.bat
Using PowerShell:
.venv\Scripts\Activate.ps1
If you encounter an error about script execution in PowerShell, try running:
powershell -ExecutionPolicy ByPass -File .venv\Scripts\Activate.ps1
With the environment set up, you can now run the script. In the terminal or command prompt, execute:
python cli.py
Now, follow the instructions on screen and choose your desired options, the script will handle the rest.
And that's it! After running the script, head over to the output folder to see your nice word clouds, graphs, and neatly formatted Markdown files. Enjoy !
Tweet Your Discoveries:
See How to use the JS script for instructions on how to download new conversations.
I hope you find this tool useful. I'm continuously looking to improve on this, but I need your help for that.
Whether you're a tech wizard or you're new to all this (especially if you're new to all this), I'd love to hear about your journey with the tool. Found a quirk? Have a suggestion? Or just want to send some good vibes? I'm all ears!
Here's how you can share your thoughts:
GitHub Issues: For more specific feedback or if you've stumbled upon a bug, please open an issue. This helps me track and address them effectively.
GitHub Discussions: If you just want to share your general experience, have a suggestion, or maybe a cool idea for a new feature, jump into the discussions page. It's a more casual space where we can chat.
And if you've had a great experience, consider giving the project a star โญ. It keeps me motivated and helps others discover it!
Thank you for being awesome! ๐
Feel free to fork this repository and make your enhancements or improvements. ALL contributions are welcome !
This project requires Python 3.8.7 or higher if on Windows. See known issue
This is just a small thing I coded to help me see my convos in beautiful markdown, in Obsidian (my go-to note-taking app).
I wasn't a fan of the clunky, and sometimes paid, browser extensions.
I'm working on automating it to add new conversations and updating old ones. Had some luck with a JavaScript bookmarklet, still ironing it out tho. Shouldn't take long.
for an older version with no external dependencies (no virtual environment needed), see https://github.com/mohamed-chs/chatgpt-history-export-to-md/tree/fe13a701fe8653c9f946b1e12979ce3bfe7104b8.