Convoviz π: Empowering Your ChatGPT Experience with Enhanced Visualization
Convoviz is an innovative tool that transforms the way users interact with their ChatGPT history. By converting historical data into well-formatted Markdown files, it opens new possibilities for analyzing and visualizing chat interactions. This project is not just about exporting data; it provides diverse features such as word clouds, prompt history graphs, and access to customized instructions in one consolidated location.
Key Features
- YAML Headers: These are optional and included by default to provide structured metadata.
- Message Version Tracking: Allows users to keep track of prompt and response edits, ensuring no version is lost.
- Code Interpreter: Facilitates code block environments and shows execution results directly within the data.
- Data Visualizations: Generating word clouds and graphs offers an insightful look into chat data in a visually appealing manner.
- Customized Instructions: All personalized instructions are compiled into a single JSON file for ease of reference and application.
How to Use π
1. Export Your ChatGPT Data π
Begin by signing into your account at chat.openai.com and exporting your chat history. Follow these steps:
- Click your Profile Name at the bottom left.
- Open Settings and navigate to Data controls.
- Select Export and confirm your export request.
- When you receive an email from OpenAI, download the
.zipfile.
2. Install the Tool π
To install Convoviz, use the following command in your terminal or command prompt:
pip install convoviz
3. Run the Script πββοΈ
With Convoviz installed, execute the following in your terminal:
python -m convoviz
Follow the prompts, select your options, and let the script take care of the rest.
4. Check the Output π
Upon script completion, head to the output folder to explore your newly-created visualizations, including word clouds and graphs, as well as neatly formatted Markdown files.
How to Add New Conversations β
For instructions on downloading new conversations, refer to How to use the JS script.
Community Engagement and Feedback π
The development of Convoviz is an ongoing journey, and user feedback is crucial for improvement. Hereβs how users can contribute:
- GitHub Issues: If you identify bugs or specific issues, report them on the issues page.
- GitHub Discussions: Share your experiences, suggestions, or ideas for new features on the discussions page.
Consider giving the project a star β on GitHub if it meets your expectations. It motivates the developer and aids in project discovery for others.
Technical Details and Ongoing Development
Convoviz requires Python 3.8.7 or higher for Windows users. It was developed to transform chat histories into aesthetically pleasing Markdown documents, primarily for use in Obsidian, a popular note-taking application. The tool also serves as a learning platform for Python and type annotations.
The package is importable into other projects, offering flexibility in how it can be integrated or expanded upon. For queries related to usage, the developer is open to providing assistance.
Future updates aim at automating the addition of new conversations, with ongoing efforts in JavaScript bookmarklet development to streamline this process.
For a version without dependencies, visit the archived version.