Skip to main content

Get analytics and visualizations on your ChatGPT data !

Project description

Convoviz 📊: Visualize your entire ChatGPT data !

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.

GitHub last commit GitHub issues

Features

  • YAML Headers: Optional and included by default.
  • Track message versions: prompt/response edits included.
  • Code Interpreter: Environment code blocks and execution results.
  • Data Visualizations: Word clouds, graphs, and more.
  • Custom Instructions: All your custom instructions in one JSON file.

See examples here.

How to Use 📖

1. Export Your ChatGPT Data 🗂

  • Sign in at chat.openai.com.
  • Navigate: Profile Name (bottom left) -> Settings -> Data controls -> Export -> Confirm export.
  • Await email from OpenAI and download the .zip file.

2. Install the tool 🛠

Open a terminal or command prompt and run:

pip install convoviz

to install the package.

3. Run the Script 🏃‍♂️

With the package installed, run the following command in your terminal:

python -m convoviz

Next, follow the instructions displayed and choose your desired options, the script will handle the rest.

4. Check the Output 🎉

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:

Tweet

How to add new conversations ➕

See How to use the JS script for instructions on how to download new conversations.

Share Your Feedback! 💌

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:

  1. 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.

  2. 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! 🌟

Notes

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.

It was also a great opportunity to learn more about Python and type annotations. I had mypy, pyright, and ruff all on strict mode, 'twas fun.

It also works as package, so you can import it in your own projects, and use the models and functions as you wish. I need to add more documentation for that tho. Feel free to reach out if you need help.

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 zero dependencies, see https://github.com/mohamed-chs/chatgpt-history-export-to-md/tree/fe13a701fe8653c9f946b1e12979ce3bfe7104b8.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

convoviz-0.1.7.tar.gz (1.9 MB view details)

Uploaded Source

Built Distribution

convoviz-0.1.7-py3-none-any.whl (1.9 MB view details)

Uploaded Python 3

File details

Details for the file convoviz-0.1.7.tar.gz.

File metadata

  • Download URL: convoviz-0.1.7.tar.gz
  • Upload date:
  • Size: 1.9 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.7.0 CPython/3.12.0 Windows/11

File hashes

Hashes for convoviz-0.1.7.tar.gz
Algorithm Hash digest
SHA256 1da6fab68aa181dcf2abd8ad66c1cddf0ba35e7236d74b229c2d5ea780a219e3
MD5 1c872c5ceed643b307cade94d950c719
BLAKE2b-256 045617996f708e1fdb91653880f874a003316da8bd9cf6119cdf6411420426b1

See more details on using hashes here.

File details

Details for the file convoviz-0.1.7-py3-none-any.whl.

File metadata

  • Download URL: convoviz-0.1.7-py3-none-any.whl
  • Upload date:
  • Size: 1.9 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.7.0 CPython/3.12.0 Windows/11

File hashes

Hashes for convoviz-0.1.7-py3-none-any.whl
Algorithm Hash digest
SHA256 3cd6dacca7aafb11ac3473102e73ee3bb26db5310c4fdb91341a57191ecb6bd8
MD5 f08c46cec0057e39ce701285bc480400
BLAKE2b-256 46adab75e53dbba4fac4e5114d6ee4d941bd1ca5ea119235d32477717142c493

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page