From 4551bb37f134fe3260163fb84cf367f2726f01aa Mon Sep 17 00:00:00 2001
From: Karl Preisner <karl@preisner.us>
Date: Fri, 23 Oct 2026 12:44:17 -0600
Subject: [PATCH] Link the live demo from the README and paper

---
 README.md     |  3 ++-
 docs/paper.md | 16 +++++++++++-----
 2 files changed, 13 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index 27ef369..46ca578 100644
--- a/README.md
+++ b/README.md
@@ -49,7 +49,8 @@ including retries.
 
 ## Quick start
 
-Requires [uv](https://docs.astral.sh/uv/).
+No install needed to try it: the [live demo](https://kpreisner.github.io/chip/) runs CHIP in
+your browser. To run it locally, you need [uv](https://docs.astral.sh/uv/).
 
 ```sh
 uv sync
diff --git a/docs/paper.md b/docs/paper.md
index 74a62c5..b68016b 100644
--- a/docs/paper.md
+++ b/docs/paper.md
@@ -4,6 +4,9 @@ Karl Preisner
 
 *Originally developed and written in 2018; revised in 2026.*
 
+▶️ **Live demo:** [kpreisner.github.io/chip](https://kpreisner.github.io/chip/) runs CHIP in
+your browser and shows each salt attempt and collision as it happens.
+
 ## Abstract
 
 In 2013, a group of cryptographers launched a public
@@ -272,11 +275,14 @@ purpose-built designs like Argon2id remain the right choice in practice.
 
 ## Try it
 
-From a clone of this repository: `HASH_NAME` is the hash function applied on every iteration, `BITS` is $b$, the number
-of low bits compared, and `COLLISIONS` is $C$, the number of repeats that end the
-chain. `MAX_ITERATIONS` is the upper bound: a salt whose chain runs longer is rejected,
-and hashing restarts with a new salt. `chip verify` prints `match`, and `--verbose` logs
-each salt attempt and collision as it happens.
+The quickest way is the [live demo](https://kpreisner.github.io/chip/), which runs the
+same library in your browser with no install.
+
+From a clone of this repository: `HASH_NAME` is the hash function applied on every
+iteration, `BITS` is $b$, the number of low bits compared, and `COLLISIONS` is $C$, the
+number of repeats that end the chain. `MAX_ITERATIONS` is the upper bound: a salt whose
+chain runs longer is rejected, and hashing restarts with a new salt. `chip verify`
+prints `match`, and `--verbose` logs each salt attempt and collision as it happens.
 
 ```sh
 uv sync