Grok Export Viewer

Convert, browse, and search your Grok Chat export (prod-grok-backend.json) offline into Markdown, HTML (with live search), CSV, SQLite, or JSON.

Installation

pip install grok-export-viewer

Usage

# Place your JSON file in data/
grok-export-viewer -s data/prod-grok-backend.json -f html
open data/html/index.html  # macOS (use xdg-open on Linux, start on Windows)

# Other formats: md, csv, json, sqlite
grok-export-viewer -s data/prod-grok-backend.json -f csv

Sample Input JSON

Below is an example structure for prod-grok-backend.json:

{
  "conversations": [
    {
      "conversation": { "title": "Sample Chat" },
      "responses": [
        { "response": { "sender": "user", "message": "Hello" } },
        { "response": { "sender": "grok", "message": "Hi!" } }
      ]
    }
  ]
}

Features

• Convert Grok JSON exports to multiple formats.
• HTML output includes a searchable index.
• Lightweight and offline processing.
• Supports Python 3.8+.

Development

git clone https://github.com/your-username/grok-export-viewer.git
cd grok-export-viewer
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
pip install -e ".[test]"
python -m pytest

Contributing

See CONTRIBUTING.md for guidelines.

Changelog

See CHANGELOG.md for release history.

License

MIT License. See LICENSE for details.