diff --git a/README.md b/README.md
index c9a5eaf..89caf4d 100644
--- a/README.md
+++ b/README.md
@@ -1,9 +1,15 @@
 # cosmos
 
-> Pure astrometry + astrology engine — ephemeris, sky, sundial, tides, transits — in Rust, with a [Llimphi](https://gitea.gioser.net/sergio/llimphi) UI.
+> Pure astrometry + astrology engine — ephemeris, sky, sundial, tides, transits — in Rust, with a [Llimphi](https://github.com/tawasuyu/llimphi) UI.
 
 `cosmos` computes the sky. Around a core astrology engine sit independent astrometric extracts — `cosmos-ephemeris`, `cosmos-sky`, `cosmos-sundial`, `cosmos-tides`, `cosmos-transits`, `cosmos-pointing` — that serve sundial / tides / navigation / planning without touching the chart machinery. A GPU UI (`cosmos-app-llimphi`, `cosmos-canvas-llimphi`) renders charts, sky maps and a dense starfield.
 
+<p align="center">
+  <img src="docs/cosmos_showreel.gif" alt="cosmos showreel — a natal chart wheel drawing in with zodiac ring, planets and aspect lines, then a data panel of positions and aspects" width="900">
+  <br>
+  <sub>the real natal wheel (zodiac ring, planets, aspect lines) computed by the VSOP2013 engine, with live positions &amp; aspects</sub>
+</p>
+
 ## Run
 
 ```sh
@@ -13,8 +19,8 @@ cargo run --release -p cosmos-canvas-llimphi --example dense_starfield
 
 ## How dependencies work
 
-cosmos is a full app: its UI integrates notebooks, panels and content-addressed sources. Llimphi and every foundational dependency are pulled as git dependencies from the [`gioser`](https://gitea.gioser.net/sergio/gioser) monorepo — the suite's source of truth. The astrometric core crates (`cosmos-ephemeris`, `-coords`, `-time`, …) are pure compute with no UI deps.
+cosmos is a full app: its UI integrates notebooks, panels and content-addressed sources. Llimphi and every foundational dependency are pulled as git dependencies from the [`tawasuyu`](https://github.com/tawasuyu/tawasuyu) monorepo — the suite's source of truth. The astrometric core crates (`cosmos-ephemeris`, `-coords`, `-time`, …) are pure compute with no UI deps.
 
 ## License
 
-MIT. Builds on [Llimphi](https://gitea.gioser.net/sergio/llimphi) and the [gioser](https://gitea.gioser.net/sergio/gioser) suite.
+MIT. Builds on [Llimphi](https://github.com/tawasuyu/llimphi) and the [tawasuyu](https://github.com/tawasuyu/tawasuyu) suite.
diff --git a/docs/cosmos_showreel.gif b/docs/cosmos_showreel.gif
new file mode 100644
index 0000000..e3b9386
Binary files /dev/null and b/docs/cosmos_showreel.gif differ
diff --git a/docs/cosmos_showreel.mp4 b/docs/cosmos_showreel.mp4
new file mode 100644
index 0000000..59dc505
Binary files /dev/null and b/docs/cosmos_showreel.mp4 differ