logactyl 0.1.5

Build a browsable local mirror site from ChatGPT or Claude data exports

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

Flag	Description
--chatgpt-zip PATH	Path to a ChatGPT data export ZIP
--claude-zip PATH	Path to a Claude data export ZIP
-o, --output DIR	Output directory (default: derived from input)
--append	Merge into an existing site instead of overwriting
--encrypt	Encrypt the output site with a passphrase
--decrypt DIR	Decrypt an existing encrypted site
--rekey DIR	Change the passphrase on an encrypted site
--render-markdown	Enable CommonMark rendering (needs markdown-it-py)
--no-render-markdown	Disable markdown rendering (raw text)
--zip	Produce a .zip of the output site
--add-search DIR	Add search to an existing site that was built without it

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.