Metadata-Version: 2.4
Name: grok-export-viewer
Version: 0.1.3
Summary: Convert and browse Grok Chat export JSON as Markdown, HTML, CSV, SQLite, and JSON.
Project-URL: Homepage, https://github.com/beejaksharam/grok-export-viewer
Project-URL: Repository, https://github.com/beejaksharam/grok-export-viewer
Project-URL: Issues, https://github.com/beejaksharam/grok-export-viewer/issues
Project-URL: Changelog, https://github.com/beejaksharam/grok-export-viewer/blob/main/CHANGELOG.md
Author: 12suresa
License: MIT
License-File: LICENSE
Keywords: chat,converter,csv,export,grok,html,json,markdown,sqlite
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Text Processing
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Requires-Dist: markdown<4.0,>=3.4.1
Requires-Dist: pygments<3.0,>=2.15.0
Requires-Dist: tqdm<5.0,>=4.66.0
Provides-Extra: test
Requires-Dist: pytest-cov>=4.0; extra == 'test'
Requires-Dist: pytest>=7.0; extra == 'test'
Description-Content-Type: text/markdown

# Grok Export Viewer

[![PyPI](https://img.shields.io/pypi/v/grok-export-viewer)](https://pypi.org/project/grok-export-viewer/)
[![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/your-username/grok-export-viewer/blob/main/LICENSE)
[![Python](https://img.shields.io/pypi/pyversions/grok-export-viewer)](https://pypi.org/project/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

```bash
pip install grok-export-viewer
```

## Usage

```bash
# 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:

```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

```bash
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](CONTRIBUTING.md) for guidelines.

## Changelog

See [CHANGELOG.md](CHANGELOG.md) for release history.

## License

MIT License. See [LICENSE](LICENSE) for details.
