GPT Exporter  
⭐ Local ChatGPT Archive Viewer — Offline-first, Private, Portable

Current release: v0.1.1-nova

GPT Exporter is a fully offline desktop application for opening, processing, and browsing your official ChatGPT data export.  
The program includes a Windows graphical interface, a built-in local HTML/JS viewer, and a clean portable structure that keeps all your data strictly on your device.

This project was developed with the assistance of modern AI tools.  
The focus is on building a simple, transparent, and efficient desktop application with a clean local-first architecture.

The application is provided AS IS.

-------------------------------------------------------------------------------

⭐ FEATURES

• Offline-first
• Processes official ChatGPT export ZIP  
• Splits conversations into per-chat text-only JSON files
• Includes a lightweight local HTTP server (127.0.0.1)  
• Local web viewer with deep linking  
• Windows GUI (PySide6)  
• Portable EXE — no installation required  
• Copy buttons for messages and code blocks  
• No telemetry or analytics by default
• Simple, transparent, and easy to extend

-------------------------------------------------------------------------------

📦 DOWNLOAD (Windows EXE)

Official downloads:  
https://gpt-exporter.com/downloads

Each release includes:  
• gpt-exporter.exe (portable)  
• ZIP archive version  
• SHA256 checksum  

Download → Run → Use.

-------------------------------------------------------------------------------

🎯 PURPOSE OF THE PROJECT

1. Practical use  
   A fast, private way to browse ChatGPT exports, including large archives.

2. Design goal  
   Focuses on simplicity, transparency, and ease of use while maintaining full local control over data.

The entire codebase was intentionally kept simple, clean, and readable.

-------------------------------------------------------------------------------

🧱 HOW IT WORKS (ARCHITECTURE)

GPT Exporter consists of two main components:

1. Desktop Application (Python)  
   - Written with PySide6  
   - Starts a lightweight local server on 127.0.0.1  
   - Runs export.py to process the ChatGPT export ZIP  
   - Saves extracted chats into:

     <folder_with_exe>/chats/first/

2. Local Web Viewer (HTML/CSS/JS)  
   - Served by the built-in server  
   - Displays JSON chat files stored on disk  
   - Provides navigation, scroll tracking, deep links, and formatting  
   - Runs fully offline in your browser  

All data is handled locally.

-------------------------------------------------------------------------------

📁 REPOSITORY STRUCTURE

gpt-exporter/  
  app/  
    main.py  
    export.py  
    app.ico  

  web/  
    gpt-exporter.html  
    styles.css  
    scripts.js  
    favicon.ico  

  docs/  

  .github/  

  README.md  
  LICENSE  
  CHANGELOG.md  
  CONTRIBUTING.md  
  CODE_OF_CONDUCT.md  
  SECURITY.md  

  .gitignore  
  .gitattributes  
  requirements.txt  

-------------------------------------------------------------------------------

🚀 QUICK START FOR USERS

1. Download the EXE from the official website.  
2. Run gpt-exporter.exe.  
3. Export your data from ChatGPT:  
   Settings → Data Controls → Export Data  
4. Load the ZIP in GPT Exporter using “Choose ZIP → Export”.  
5. Press “Open local viewer” — the viewer opens in your browser.

Done.

-------------------------------------------------------------------------------

🛠 QUICK START FOR DEVELOPERS

Clone the repository:  
git clone https://github.com/gpt-exporter/gpt-exporter.git  
cd gpt-exporter  

Create virtual environment:  
python -m venv .venv  
.venv\Scripts\activate  

Install dependencies:  
pip install -r requirements.txt  

Run development version:  
py app\main.py  

Build standalone EXE (PyInstaller):  
py -m PyInstaller --noconfirm --clean --onefile --windowed `
  --name "GPT-Exporter" `
  --icon "app\app.ico" `
  --hidden-import "app.export" `
  --add-data "app\export.py;app" `
  --add-data "app\app.ico;app" `
  --add-data "web;web" `
  app\main.py  

Resulting EXE appears in:
dist/GPT-Exporter.exe

-------------------------------------------------------------------------------

🔐 SECURITY AND PRIVACY

• No external connections related to user data processing in the current version
• Viewer runs strictly on 127.0.0.1  
• No telemetry or analytics  
• No cloud communication  
• User chat data is stored at:
  <folder_with_exe>/chats/first/

• Application logs and temporary working data are stored next to the executable in:
  <folder_with_exe>/.gpt-exporter/
  <folder_with_exe>/app.log
  <folder_with_exe>/crash.dump

Full security details in SECURITY.md.

-------------------------------------------------------------------------------

🤝 CONTRIBUTING

Contributions are welcome:  
• Bug reports  
• Feature ideas  
• Code improvements  
• Documentation updates  

Please read CONTRIBUTING.md before submitting pull requests.

-------------------------------------------------------------------------------

🚧 FUTURE VERSIONS

Planned versions of GPT Exporter:

- v0.1 — Nova
  - v0.1.1 — Nova (current)
- v0.2 — Core
- v0.3 — Flux
- v0.4 — Axis
- v0.5 — Halo
- v1.0 — Prime

Future releases may introduce feature-based editions (free / pro / business) while preserving the offline-first architecture.

Versions are planned without fixed release dates.

-------------------------------------------------------------------------------

📜 LICENSE

The project is open-source under the license provided in the LICENSE file.

-------------------------------------------------------------------------------

⚠ DISCLAIMER

This application was developed with the assistance of AI tools.  
It is provided AS IS, without warranty of any kind.  
Use at your own risk.

-------------------------------------------------------------------------------

❤️ CREDITS

• AI tools used during development
• Testers and early users  
• The open-source community