Please help me install and set up "Poppy" from veered.org on my own computer or server. What it is: Bizarre patent game: guess what a real patent is for, or pick the real one from a fake. It runs on: Any web browser: nothing to install, no account. Project page: https://veered.org/bizarre-patent-game/ Source code download (zip): https://github.com/veered-org/poppy-bizarre-patent-game/archive/refs/heads/main.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 ===== # Bizarre Patent Game (Poppy): guess what a real patent is for Poppy is a browser game built on real, bizarre US patents: the comb-over, the method of swinging on a swing, the machine that kicks its user. It has two modes. - **Guess the patent.** One drawing appears. Type what the patent is for, or ask for the next clue: a second drawing, then a passage from the patent with the giveaway words blanked out. The first clue is worth up to 100 points, the second up to 70, the third up to 40. The reveal shows the title, number, year, owner, every drawing and a link to Google Patents. - **Real or fake.** A real patent sits beside an invented one, each with a drawing and a passage. Pick the real one for 50 points. ![Three drawings from the game above the guess box](docs/screenshot.png) **Try it:** open `index.html` from any web server (`python3 -m http.server`). No account; the score lasts for the browser session. ## How guesses are scored Every patent has a plain-English description of 8 to 12 words ("hiding a bald spot by combing long side hair over it"). A small sentence-embedding model ([all-MiniLM-L12-v2](https://huggingface.co/sentence-transformers/all-MiniLM-L12-v2), run in the browser by [transformers.js](https://huggingface.co/docs/transformers.js)) turns the guess and the description into vectors. Their cosine similarity is rescaled to 0 to 100 (0.30 and below is 0; 0.72 and above is 100) and capped by the clue level. Scoring is by meaning, so "kicks you in the butt" does well against "a machine that kicks the user in the buttocks". The official titles are not used for scoring: they vary too much in length and wording. The model (about 35 MB) is downloaded once and cached. If it cannot load, the game falls back to counting shared words. ## The data `data/patents.json` holds one entry per patent: number, official title, description, issue year, owner (assignee, or first inventor when unassigned), figures in clue order, excerpt, Google Patents link, and whether it is real or invented. Invented entries carry only a title, a figure and an excerpt; their drawings are borrowed from ordinary real patents, credited at the reveal. The drawings in `img/` are the patents' own sheets. Whole scanned sheets print the title across the top, which would give the answer away, so `tools/build_images.py` erases the header lines and drops pages of text. To rebuild or extend the set: ``` python3 tools/fetch_patents.py numbers.txt # title, dates, owner, text and sheets from Google Patents python3 tools/build_images.py work/img img numbers.txt > work/manifest.json python3 tools/build_data.py work . # needs work/llm/out_*.json and work/fakes.json ``` The descriptions, excerpts and invented patents were written with Claude and checked by script (word counts, required fields, files present). ## Name Poppy: the red wildflower that turns up where nobody planted it. MIT License for the code. Patent text and drawings are from the public record. ----- For Claude Code users ----- Download https://github.com/veered-org/poppy-bizarre-patent-game/archive/refs/heads/main.zip, unzip it into a new folder, read every README.md in it, and help me install and set up "Poppy" (Bizarre patent game: guess what a real patent is for, or pick the real one from a fake) 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.