distill-llm 0.0.0-stage → 0.1.2

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Jesus Nieves
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,3 +1,273 @@
-# Temporary Holding Version
+<p align="center">
+  <img src=".github/assets/banner.png" alt="distill: Documents in. Fewer tokens out." width="100%">
+</p>
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+<p align="center">
+  <b>Turn PDFs, Office files and scans into token-lean Markdown for your LLM and your coding agent.</b><br>
+  Local-first. No telemetry. Web app, desktop app, CLI, MCP server and Claude Code / OpenCode hooks.
+</p>
+
+<p align="center">
+  <a href="https://github.com/nievesjesus/distill/actions/workflows/ci.yml"><img src="https://github.com/nievesjesus/distill/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://www.npmjs.com/package/distill-llm"><img src="https://img.shields.io/npm/v/distill-llm?color=C8F53C&labelColor=0B0B10" alt="npm"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-C8F53C?labelColor=0B0B10" alt="License: Apache-2.0"></a>
+  <img src="https://img.shields.io/badge/node-%E2%89%A522.12-C8F53C?labelColor=0B0B10" alt="Node 22.12+">
+  <img src="https://img.shields.io/badge/runs-100%25%20local-C8F53C?labelColor=0B0B10" alt="Runs 100% local">
+</p>
+
+<p align="center">
+  <a href="https://nievesjesus.github.io/distill/">Website</a> ·
+  <a href=".github/assets/distill-launch.mp4">Launch video</a> ·
+  <a href="#quick-start">Quick start</a> ·
+  <a href="#use-it-from-your-agent">Agents (MCP + hooks)</a> ·
+  <a href="#faq">FAQ</a>
+</p>
+
+<p align="center">
+  <img src=".github/assets/demo.gif" alt="Dropping five PDFs into distill and watching the token counts drop" width="720">
+</p>
+
+## Why
+
+Coding agents read PDFs the expensive way. We asked Anthropic's token counting API how many input tokens Claude needs for five demo PDFs, once as the raw PDF and once as distill's Markdown:
+
+| Document | Pages | Raw PDF | distill Markdown | Saved |
+|---|---:|---:|---:|---:|
+| `vendor-contract.pdf` | 7 | 14,021 | 2,829 | **−80%** |
+| `product-roadmap.pdf` | 8 | 16,518 | 3,870 | **−77%** |
+| `q3-financial-report.pdf` | 12 | 24,978 | 6,357 | **−75%** |
+| `inventory-export.pdf` | 9 | 24,091 | 9,871 | **−59%** |
+| `sales-ledger.pdf` | 7 | 18,693 | 8,066 | **−57%** |
+| **Total** | 43 | **98.3k** | **31.0k** | **−68%** |
+
+<sub>Measured on 2026-11-07 with <code>POST /v1/messages/count_tokens</code> and <code>claude-sonnet-5-5</code>. The documents are generated by <code>scripts/marketing/make-demo-docs.mjs</code> and the numbers are reproducible with <code>npm run marketing:measure</code>. Your files will differ.</sub>
+
+On top of that, distill's lossless boosters trim another 10% from LiteParse's Markdown on the same files (24.9k → 22.4k `o200k_base` tokens). LiteParse already returns clean Markdown, so that extra step is modest; it is bigger on table- and link-heavy documents.
+
+## Features
+
+- **One engine, many doors.** The same local pipeline behind a web app, a desktop app, a Docker image, a CLI, an MCP server and hooks for Claude Code and OpenCode.
+- **Real parsing.** [LiteParse](https://github.com/run-llama/liteparse) by LlamaIndex reads PDFs, DOCX, PPTX, XLSX, ODF and images (with OCR).
+- **Lossless boosters.** Small, deterministic passes drop repeated boilerplate, image paths and link targets, table padding and extra whitespace. Content words stay.
+- **Optional LLMLingua-2.** A local model for when you want to go further and accept a lossy result. Off by default, installed on demand.
+- **Honest numbers.** Every file's before and after token counts come from a real tokenizer, live in the UI.
+- **Private by design.** Files are parsed on your machine. No telemetry, no analytics, no CDN.
+
+## Quick start
+
+```bash
+npx distill-llm
+```
+
+This starts a local server at `http://127.0.0.1:4321` and opens the web UI. Drop files in, read the Markdown, copy it or download it (one `.md` or a ZIP of all of them).
+
+<p align="center">
+  <img src=".github/assets/screenshot-compact.png" alt="Compact view with five files and their token savings" width="45%">
+  &nbsp;
+  <img src=".github/assets/screenshot-detailed.png" alt="Detailed view with the booster switches" width="45%">
+</p>
+
+## Use it from your agent
+
+### MCP server
+
+Give any MCP client three tools: `distill_file`, `distill_files` and `distill_capabilities`.
+
+```bash
+claude mcp add distill -- npx -y distill-llm mcp
+```
+
+Any other client:
+
+```json
+{
+  "mcpServers": {
+    "distill": { "command": "npx", "args": ["-y", "distill-llm", "mcp"] }
+  }
+}
+```
+
+`distill_file({ path, boosters?, lingua? })` returns the Markdown plus `{ tokens: { raw, out }, pages, kind }`. `distill_files` takes up to 20 paths and reports a per-file error instead of failing the whole call.
+
+For clients that speak HTTP, `distill-llm mcp --http` serves Streamable HTTP at `http://127.0.0.1:4322/mcp`. Over HTTP the server only reads files inside the directories you pass with `--root` (repeatable, default: the current directory) and compares real paths, so symlinks cannot escape. It rejects cross-site requests and answers only to loopback names, IP addresses and the hostnames you list with `--allowed-hosts`, which blocks DNS rebinding.
+
+<details>
+<summary>Remote clients such as ChatGPT connectors</summary>
+
+The HTTP server has **no authentication**: anyone who can reach it can read every file under `--root`. Never publish it directly to the internet. To use it from a remote client:
+
+1. Point `--root` at a folder that holds only the documents you want to share.
+2. Put an HTTPS tunnel **with authentication** in front of it (for example Cloudflare Tunnel with Cloudflare Access, or Tailscale Funnel restricted to your tailnet).
+3. Allow the tunnel's hostname, or every request gets 403:
+
+```bash
+distill-llm mcp --http --root ~/shared-docs --allowed-hosts distill.example.com
+```
+
+4. Add `https://distill.example.com/mcp` as the connector URL in your client.
+</details>
+
+### Hooks: make your agent read Markdown instead of the binary
+
+```bash
+npm i -g distill-llm
+distill-llm hooks install --claude     # Claude Code
+distill-llm hooks install --opencode   # OpenCode
+```
+
+- **Claude Code:** adds a `PreToolUse` hook on `Read` to `~/.claude/settings.json` (or your personal `.claude/settings.local.json` with `--project`). When Claude reads a PDF or Office file inside the project it is working in, the hook converts it once, caches it by content hash in `~/.cache/distill-llm/out/` (private to your user) and points the read at the Markdown. It also adds the permission rule `Read(~/.cache/distill-llm/out/**)` so those reads do not prompt.
+- **OpenCode** (experimental): writes a plugin to `~/.config/opencode/plugins/distill.js` (or `.opencode/plugins/` with `--project`) that does the same on `tool.execute.before` for `read`. OpenCode's plugin API is changing; if the plugin does not apply, OpenCode simply reads the original file.
+
+The installer shows the exact change and asks before writing (`--yes` skips the question). It keeps your other settings, follows symlinked dotfiles, keeps the file mode, and masks existing values in the diff it prints. `distill-llm hooks uninstall --claude|--opencode` removes only what it added. Install it globally first: a command written from a temporary `npx` run would disappear.
+
+The hooks respect your permissions and never block a read:
+
+- Files outside the project the agent works in are not converted, so Claude Code asks you about them as usual.
+- If any `deny` or `ask` rule for `Read` exists in your user, project (any parent folder or `CLAUDE_PROJECT_DIR`), local or managed settings, or one of those files can't be read, the Claude Code hook stays out of the way entirely. Rules passed on the command line (`--settings`, `--disallowedTools`) are invisible to hooks.
+- Images and CSV files are left alone.
+- If anything fails (a missing file, a timeout, a password-protected PDF, a scan with no text), the agent reads the original file.
+
+Set `DISTILL_HOOK=off` to disable the Claude Code hook for a session.
+
+### CLI
+
+```bash
+npx distill-llm convert report.pdf deck.pptx --out md/
+```
+
+| Option | Does |
+|---|---|
+| `--out <dir>` | Write the `.md` files into a directory (default: next to each input) |
+| `--boosters <list>` | Only these boosters: `dedupe`, `media`, `tables`, `ws` |
+| `--no-optimize` | Plain LiteParse Markdown, no boosters |
+| `--lingua [--rate 0.5]` | Add LLMLingua-2 (must be installed from the web app first) |
+| `--json` | Print a JSON array with tokens, pages and timings per file |
+| `--stdout` | Print the Markdown of a single file instead of writing it |
+
+Each file prints a summary such as `report.pdf → report.md  5.7k → 4.6k tokens (−19%)`. The exit code is 1 if any file failed; the others are still converted.
+
+## Desktop app and Docker
+
+**Desktop:** installers for macOS (arm64, x64), Windows (x64) and Linux (x64) are on [GitHub Releases](https://github.com/nievesjesus/distill/releases). They are named without a version (`Distill-lite-mac-arm64.dmg`, `Distill-lite-mac-x64.dmg`, `Distill-lite-win-x64.exe`, `Distill-lite-linux-x86_64.AppImage`), so `https://github.com/nievesjesus/distill/releases/latest/download/<file>` always points at the newest release. `Distill-lite-*` has everything except LLMLingua-2; `Distill-full-*` bundles its runtime and is published for Apple Silicon, Windows x64 and Linux x64. Intel Macs get the lite build only.
+
+<details>
+<summary>Unsigned installers: how to open them the first time</summary>
+
+- **macOS 15 and later:** open the app once and dismiss the warning, then go to System Settings > Privacy & Security and click **Open Anyway**.
+- **macOS 14 and earlier:** right-click the app, choose **Open**, then confirm **Open**.
+- **"The app is damaged":** run `xattr -dr com.apple.quarantine /Applications/distill.app` and open it again.
+- **Windows:** in the SmartScreen dialog click **More info**, then **Run anyway**.
+
+Release builds are signed when the signing certificates are configured; if your installer is unsigned, the steps above apply. The desktop app has no auto-update. OCR data is bundled; Office files still need LibreOffice installed.
+</details>
+
+**Docker:** LibreOffice and the English OCR data are included, so every format works out of the box.
+
+```bash
+docker run --rm -p 4321:4321 -v distill-cache:/home/node/.cache ghcr.io/nievesjesus/distill
+```
+
+Open it as `http://localhost:4321` or by IP, or pass `-e DISTILL_ALLOWED_HOSTS=<name>` to reach it by hostname. Build it yourself with `docker build -t distill .`.
+
+## How it works
+
+```mermaid
+flowchart LR
+  A[PDF · DOCX · PPTX · XLSX · images] --> B[LiteParse<br/>local parse + OCR]
+  B --> C[Boosters<br/>dedupe · media · tables · ws]
+  C --> D{LLMLingua-2?<br/>optional, lossy}
+  D --> E[Markdown + token counts]
+  E --> F[Web · Desktop · CLI · MCP · Hooks]
+```
+
+| Booster | What it does | Loss |
+|---|---|---|
+| Drop repeated boilerplate | Removes identical running header/footer lines (4+ words, 25+ chars, 3+ repeats) and page-number lines such as `Page 3 of 12`. Lines that differ in any character are kept. | None |
+| Slim images and links | `![alt](path)` becomes `[alt]`, `[text](url)` becomes `text` | Drops image paths and URLs |
+| Compact tables | Removes alignment padding from GFM tables | None |
+| Collapse whitespace | Collapses blank-line runs, trailing and double spaces outside code | None |
+| LLMLingua-2 | A local model removes low-value words | **Lossy**, off by default |
+
+Boosters are pure, idempotent functions and never touch fenced code blocks or front matter. In the web app they run in your browser, so switching one on or off updates the counts instantly. If you need link targets, turn off "Slim images and links".
+
+<details>
+<summary>LLMLingua-2 details</summary>
+
+LLMLingua-2 is optional and experimental. It needs Apple Silicon, Windows x64 or Linux x64: its ONNX runtime has no Intel Mac build, so on Intel Macs the row explains this instead of offering an install. When `npm` is available, its row shows **Install (~520 MB)**: one click runs `npm ci --omit=dev --include=peer --ignore-scripts` against a lockfile with pinned versions and integrity hashes and installs the runtime into `~/.cache/distill-llm/lingua`. The first use downloads the model (TinyBERT, about 57 MB) from Hugging Face into `~/.cache/distill-llm/models`; after that it runs offline. Behind a proxy that intercepts HTTPS, give Node your organization's CA with `NODE_EXTRA_CA_CERTS=/path/to/ca.pem`. Never turn off certificate checks.
+</details>
+
+## Supported formats
+
+| Format | Needs |
+|---|---|
+| PDF | nothing else |
+| PNG, JPG, TIFF, WebP | nothing else (OCR built in; English data is downloaded once, about 15 MB) |
+| DOCX, PPTX, XLSX, ODF | [LibreOffice](https://www.libreoffice.org/download/) on your `PATH` (`soffice`); included in Docker |
+
+Password-protected PDFs are reported as an error. Parsing quality is whatever LiteParse gives you: it varies on dense tables and complex scans, and distill does not try to hide that.
+
+## Privacy
+
+Files are parsed locally and never leave your machine. There is no telemetry, no analytics and no CDN: fonts are bundled. distill makes at most three one-time downloads, all of data and never of your documents: the Tesseract English data for the first OCR (skip it with `DISTILL_TESSDATA` or `TESSDATA_PREFIX`; `DISTILL_OCR_LANG` sets the language), and, only if you enable LLMLingua-2, its runtime from npm and its model from Hugging Face.
+
+Uploaded files go to a temporary directory and are deleted after parsing. Results stay in a small in-memory cache so the JSON view can be requested later. The hooks write converted Markdown to `~/.cache/distill-llm/out/`. API responses are sent with `Cache-Control: no-store`.
+
+<details>
+<summary>Network exposure</summary>
+
+The web server only listens on loopback by default. `--host 0.0.0.0` exposes it to your network and disables the loopback check, so only do that on a network you trust: there is no authentication. On every host, state-changing `/api` requests are rejected when the browser marks them cross-site or when their `Origin` differs from the `Host`. When exposed, the server only answers to loopback names, IP addresses and the hostnames you list with `--allowed-hosts` or `DISTILL_ALLOWED_HOSTS`, which blocks DNS rebinding. A reverse proxy must keep the original `Host` header.
+</details>
+
+## How tokens are counted
+
+The app and the CLI count with `o200k_base` (via `gpt-tokenizer`). Claude and Gemini tokenize differently, so absolute counts are approximate, while the percentage saved is comparable across tokenizers. The Claude numbers at the top of this page come from Anthropic's own token counting API.
+
+## FAQ
+
+**Is it free?** Yes. Apache-2.0, no account, no paid tier.
+
+**Does anything leave my machine?** Your documents never do. See [Privacy](#privacy) for the optional one-time data downloads.
+
+**Why not just give the PDF to the model?** You can, and for charts and layout-heavy pages you sometimes should. For text, the same content as Markdown costs a fraction of the tokens: about a third on our demo files.
+
+**Will the hook break my agent?** No. It only touches PDF and Office reads inside your project, never blocks a read, respects your permission rules, and falls back to the original file on any error.
+
+**Is LLMLingua-2 safe to use on contracts?** It is lossy by design: it removes words. Keep it off when every word matters.
+
+## Roadmap
+
+- [x] Web app, desktop app and Docker image
+- [x] CLI (`distill-llm convert`)
+- [x] MCP server (stdio and HTTP)
+- [x] Hooks for Claude Code and OpenCode
+- [ ] Signed and notarized desktop builds
+- [ ] Hooks for more agents as their hook APIs settle (Codex, Gemini CLI)
+- [ ] Password-protected PDFs
+
+Ideas and votes are welcome in [Issues](https://github.com/nievesjesus/distill/issues).
+
+## Contributing
+
+```bash
+git clone https://github.com/nievesjesus/distill && cd distill
+npm ci
+npm test            # unit tests
+npm run typecheck
+npm run build
+npm run test:e2e    # Playwright, web app
+npm run test:smoke  # built CLI: convert, MCP, hooks
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md). `npm run marketing` regenerates the demo documents, screenshots and banner from the real app.
+
+<details>
+<summary>Building the desktop app</summary>
+
+Build one architecture per host: `npm run dist:full -- --arm64` on Apple Silicon or `npm run dist:full -- --x64` on Windows or Linux (Intel Macs only get `dist:lite`). `build/lingua` holds only the sharp binary of the machine that ran `npm ci`, so a cross-architecture installer would ship the wrong native module. Re-running the release workflow for a tag whose draft release already exists does not replace its installers; delete the draft first.
+</details>
+
+## License
+
+[Apache-2.0](LICENSE). Built on [LiteParse](https://github.com/run-llama/liteparse) by LlamaIndex.
+
+If distill saves you tokens, a ⭐ helps other people find it.

package/dist/chunk-FBCOKT2K.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+
+// src/core/loopback.ts
+var LOOPBACK_HOSTS = /* @__PURE__ */ new Set(["127.0.0.1", "localhost", "::1"]);
+function isLoopbackHost(host) {
+  return LOOPBACK_HOSTS.has(host.toLowerCase().replace(/^\[|\]$/g, ""));
+}
+
+export {
+  isLoopbackHost
+};