Skip to content

Repository files navigation

Liquify

Liquify lets you review AI chat transcripts from ChatGPT, Claude, Gemini, and Grok side by side on your own machine.

What Liquify Does

  • Combine official export files from multiple AI providers into one searchable archive.
  • Filter by provider, date, or message count and search across all messages.
  • Save filter settings as reusable views for quick comparisons.
  • Export any subset of conversations to JSON or Markdown for backup or sharing.

Requirements

  • Node.js 18 or later
  • npm (bundled with Node.js)
  • Modern desktop browser (Chromium, Firefox, or Safari)
  • ZIP export file from at least one supported provider

Launch Liquify

  • Use the hosted build at https://www.nickhagar.net/liquify-llm/, or follow the local steps below.
  1. Clone this repository and move into it.
  2. Install dependencies with npm install.
  3. Start the app with npm run dev.
  4. Open the printed local URL (defaults to http://localhost:5173) in your browser. Keep the terminal window open while you use the app.
  5. When you are done, press Ctrl+C in the terminal to stop the server.

For a production build you can run npm run build followed by npm run preview. The preview server listens on http://localhost:4173.

Prepare Your Exports

Liquify accepts the ZIP files produced by the official export tools listed below. Do not unzip the downloads.

ChatGPT

  1. Visit Settings → Data Controls → Export data.
  2. Request an export and wait for the email from OpenAI.
  3. Download the .zip file from the email link.

Claude

  1. Go to https://claude.ai/settings.
  2. Request a data export under Data & Privacy.
  3. Download the ZIP once the email arrives.

Gemini

  1. Open https://takeout.google.com/.
  2. Deselect all products, then add My ActivityGemini.
  3. Create the export and download the resulting archive.
    Google splits Gemini data into individual prompt/response pairs, so each pair appears as its own conversation in Liquify.

Grok

  1. Sign in at https://x.com/settings/download_your_data.
  2. Request your data export and select the Grok option.
  3. Download the ZIP when Twitter notifies you that it is ready.

Import Into Liquify

  1. Launch Liquify and pick the provider whose ZIP you plan to upload.
  2. Review the built-in step-by-step guide (shown on the right side of the importer).
  3. Use Choose ZIP file to select the untouched export file.
  4. Click Process File. Liquify validates, normalizes, and stores the conversations locally.
  5. Repeat for other providers. Each successful import updates the summary on the home screen.
  6. Use View All Conversations to switch to the threaded view.

You can delete previously imported data at any time from the main screen without affecting your original exports.

Work With Your Conversations

  • Search and filter: Filter by provider, date range, and message count, and run full-text searches across every message.
  • Saved views: Save any combination of filters and search terms for later reuse. Saved views sync to your browser storage.
  • Thread detail: Select a thread to see the full conversation with role labels, timestamps, and attachments.
  • Exports: Download the current filter results or your entire archive as JSON or Markdown. Liquify can bundle multiple formats into a single ZIP. You can include metadata (timestamps, message counts) or keep the export minimal.

Data Handling and Privacy

  • All parsing happens inside your browser; no data is uploaded or sent to any server.
  • Imported conversation data stays in memory only. Refreshing or closing the tab clears it, so plan to keep the page open while you work.
  • Saved views are the only items written to localStorage so you can reuse them across sessions.
  • No analytics, telemetry, or external calls are made during normal use.

Troubleshooting

  • “Invalid file” after upload: Confirm you selected the provider’s unmodified ZIP file. If you have multiple exports, pick the newest one.
  • Nothing shows up after import: Reload the page to reset, then run the import again with the matching provider ZIP. Keep the tab open afterward so the conversations stay available.
  • Stuck processing large exports: Keep the tab focused while the progress spinner is active. Very large ChatGPT exports can take a few minutes.

Need Help?

Open an issue on GitHub with the export provider, the date of the download, and any error messages shown in the app.

License

Liquify is released under the MIT License. See LICENSE for the full text.

About

Local tool for exporting and exploring your LLM conversations

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages