Please help me install and set up "Claret" from veered.org on my own computer or server. What it is: Trademark ID finder: type what you sell, get the USPTO ID Manual wording and class. It runs on: Any web browser: nothing to install, and what you type never leaves your computer. Project page: https://veered.org/trademark-id-finder/ Source code download (zip): https://veered.org/trademark-id-finder/claret-trademark-id-finder.zip How I'd like you to help: 1. First ask me what you need to know: my operating system and version, my desktop environment if it matters, whether I'm comfortable with the terminal, and any accounts or hardware this project needs. 2. Then take me through it one step at a time. For each command, say briefly what it does, and wait for me to paste back the result before moving on. 3. Before any step that changes system settings, uses sudo, or edits an existing configuration file, tell me, and have me make a backup first. 4. If something fails, help me work out why. If the instructions below don't fit my system, say so rather than guessing. 5. At the end, show me how to check that it works, and how to uninstall it. The project is shared as-is by its author, with no warranty. If we find a problem in the project itself, please help me write a short, clear note I can send to support@veered.org. Here is the project's documentation (README files from the download): ===== README.md ===== # Trademark ID Finder (Claret): find the USPTO-approved wording for what you sell Claret is a one-page search of the USPTO Trademark ID Manual. You type what you sell in your own words ("scented candles", "an app for booking yoga classes", "online clothing store") and it lists the closest pre-approved goods and services descriptions, with their classes. You add the ones that fit to a list, fill in any `{blanks}`, and copy the identification for each class into the application. Choosing ID Manual wording instead of writing your own description avoids the USPTO's $200-per-class free-form fee and many examiner objections to the identification. ![Search results for legal software, with entries for three classes on the list](docs/screenshot.png) **Try it:** open `index.html` from any web server (`python3 -m http.server`). ## How it matches - A small sentence-embedding model ([all-MiniLM-L6-v2](https://huggingface.co/sentence-transformers/all-MiniLM-L6-v2), through [transformers.js](https://huggingface.co/docs/transformers.js)) turns the query into a vector in the browser. The model (about 25 MB) is downloaded once and cached. - Every ID Manual entry has a pre-computed vector, stored as one sign bit per dimension (`data/vectors.bin`, 48 bytes per entry, 3.3 MB). The query is scored against all 68,000+ entries in a few milliseconds, then blended with a plain word match. - Apps, software and stores get the ID Manual's fill-in entries first ("Downloadable mobile applications for {…}", "Software as a service (SAAS) services featuring software for {…}", "Retail store services featuring {…}"), with the blank filled from the query. - If the model cannot load, it falls back to the word match. Nothing you type leaves your browser. The list you build is kept in the browser's local storage. ## Updating the data Download the full manual from the [ID Manual](https://idm-tmng.uspto.gov/id-master-list-public.html) (Download → Excel; the file is an HTML table), then: ``` pip install sentence-transformers numpy python3 tools/build_data.py idmanual.xls data/ ``` Deleted entries, class 000 entries (not selectable when filing) and the certification classes A and B are left out. ## What it is not It is not legal advice and does not check whether a description fits your actual goods, or whether the mark is available. The examining attorney has the final word on every identification. ## Name Claret is the deep red of Bordeaux wine, a name the English gave it in the Middle Ages to tell it apart from the rest. MIT License. ID Manual entries are USPTO data (public domain). ----- For Claude Code users ----- Download https://veered.org/trademark-id-finder/claret-trademark-id-finder.zip, unzip it into a new folder, read every README.md in it, and help me install and set up "Claret" (Trademark ID finder: type what you sell, get the USPTO ID Manual wording and class) on this machine. Check the requirements against this system first and tell me what is missing. Ask me before running anything with sudo, installing packages, or changing existing configuration files, and back those files up first. Finish by showing me how to test it and how to uninstall it.