logactyl

Build a browsable, fully offline local mirror site from your ChatGPT or Claude data exports.

What it does

logactyl takes an official data export ZIP from ChatGPT or Claude and generates a static HTML site that you can open directly in any browser (no server required). The site includes:

• Per-conversation pages with rendered messages, code blocks, TeX math, and attachments
• Full-text offline search across all conversations
• Project/folder grouping and an interactive organizer
• Optional AES-256-GCM encryption at rest

Installation

pip install logactyl

With optional dependencies for rich markdown rendering and encryption:

pip install "logactyl[all]"

Or pick what you need:

pip install "logactyl[markdown]"   # markdown-it-py for CommonMark rendering
pip install "logactyl[encrypt]"    # cryptography for AES-256-GCM encryption

Known issues

There is currently no way to derive project names via inference using the official export archives. When either OpenAI or Anthropic add some mapping for projects in their exports it will be added to this tool.

Quick start

ChatGPT export:

logactyl --chatgpt-zip ~/Downloads/chatgpt-export.zip -o ~/chatgpt-mirror

Claude export:

logactyl --claude-zip ~/Downloads/claude-export.zip -o ~/claude-mirror

Both together (merged site):

logactyl \
  --chatgpt-zip ~/Downloads/chatgpt-export.zip \
  --claude-zip ~/Downloads/claude-export.zip \
  -o ~/chat-mirror

Then open index.html in the output directory.

Appending new exports

Re-run with --append to merge new exports into an existing site without losing organizer edits:

logactyl --chatgpt-zip newer-export.zip -o ~/chatgpt-mirror --append

Encryption

Encrypt the generated site at rest with a passphrase:

logactyl --chatgpt-zip export.zip -o ~/private-mirror --encrypt

Requires pip install "logactyl[encrypt]".

Decrypt or re-key an existing encrypted site:

logactyl --decrypt ~/private-mirror
logactyl --rekey ~/private-mirror

Options

Run logactyl --help for the full list.

Running as a module

python -m logactyl --chatgpt-zip export.zip -o ~/mirror

Requirements

• Python 3.9+
• No required third-party dependencies (stdlib only)
• Optional: markdown-it-py for rich markdown rendering
• Optional: cryptography for site encryption

License

This repository ships under 0BSD; see LICENSE.

Licensing / provenance notice

This repository may include AI-generated material and minimal human-authored material. To the extent any portion of this repository is not copyrightable, it is made available without restriction.

No bundled third-party source trees, copied dependency code, or shipped upstream license texts were identified in this source tree during this review. Separately installed dependencies remain under their own upstream licenses. See NOTICE.