diff --git a/CHANGELOG.md b/CHANGELOG.md
index cc2b25e..0b9db9e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,13 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [0.5.1] - 2026-08-24
+
+### Fixed
+- README links to the gallery and quickstart now use absolute GitHub URLs, so
+  they work on the PyPI project page (which mirrors the README but does not
+  rewrite relative links).
+
 ## [0.5.0] - 2026-08-23
 
 ### Added
@@ -144,7 +151,8 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
   `raw-rgb`, `byteclass`, `entropy`, `delta`, `xor`, `bitplane`, `nibble`.
   Pure-stdlib BMP writer and animated-GIF encoder.
 
-[Unreleased]: https://github.com/scottvr/vizbin/compare/v0.5.0...HEAD
+[Unreleased]: https://github.com/scottvr/vizbin/compare/v0.5.1...HEAD
+[0.5.1]: https://github.com/scottvr/vizbin/compare/v0.5.0...v0.5.1
 [0.5.0]: https://github.com/scottvr/vizbin/compare/v0.4.0...v0.5.0
 [0.4.0]: https://github.com/scottvr/vizbin/compare/v0.3.0...v0.4.0
 [0.3.0]: https://github.com/scottvr/vizbin/compare/v0.2.0...v0.3.0
diff --git a/README.md b/README.md
index fc48a16..a42f6a6 100644
--- a/README.md
+++ b/README.md
@@ -18,7 +18,7 @@ Two ideas drive it:
 
 Vary both and let human vision do the first pass of reconnaissance.
 
-**See it in action:** the [gallery](docs/GALLERY.md) shows real renders — the
+**See it in action:** the [gallery](https://github.com/scottvr/vizbin/blob/main/docs/GALLERY.md) shows real renders — the
 projections, channel composition, contact sheets, text mode, and the binary diff.
 
 It grew out of a shell one-liner that `cat`'d a file's bytes into a hand-built
@@ -71,7 +71,7 @@ vizbin render foo.bin -w 128 -m byteclass
 vizbin render foo.bin -w 128 -m entropy --window 512
 ```
 
-New to it? Start with the [exploration guide](docs/QUICKSTART-TUTORIAL.md) — a
+New to it? Start with the [exploration guide](https://github.com/scottvr/vizbin/blob/main/docs/QUICKSTART-TUTORIAL.md) — a
 guided tour of small experiments that show what vizbin can see, and how changing
 one assumption changes the picture.
 
diff --git a/src/vizbin/__init__.py b/src/vizbin/__init__.py
index bdb51a9..324e230 100644
--- a/src/vizbin/__init__.py
+++ b/src/vizbin/__init__.py
@@ -6,4 +6,4 @@
 # Single source of truth for the version. pyproject.toml reads this via
 # setuptools' dynamic `attr` (a static AST read -- no import, no runtime I/O),
 # and the CLI's --version wires straight to it. Bump here and nowhere else.
-__version__ = "0.5.0"
+__version__ = "0.5.1"