From 2e703e19e299948ca6bdc9f7c843f9453ec6dfc0 Mon Sep 17 00:00:00 2001
From: Joseph Magly <1159087+jmagly@users.noreply.github.com>
Date: Fri, 14 Aug 2026 10:34:34 -0400
Subject: [PATCH] docs: separate Hugging Face Space metadata

---
 README.md                             | 17 -----------------
 deploy/huggingface/README.md          | 10 ++++++++++
 deploy/huggingface/space-metadata.yml | 14 ++++++++++++++
 3 files changed, 24 insertions(+), 17 deletions(-)
 create mode 100644 deploy/huggingface/README.md
 create mode 100644 deploy/huggingface/space-metadata.yml

diff --git a/README.md b/README.md
index 8df2a11..090cf49 100644
--- a/README.md
+++ b/README.md
@@ -1,20 +1,3 @@
----
-title: OBLITERATUS
-emoji: "💥"
-colorFrom: green
-colorTo: gray
-sdk: gradio
-sdk_version: "5.29.0"
-app_file: app.py
-persistent_storage: large
-pinned: true
-license: agpl-3.0
-tags:
-  - abliteration
-  - mechanistic-interpretability
-short_description: "One-click model liberation + chat playground"
----
-
 <p align="center">
   <strong>O B L I T E R A T U S</strong>
 </p>
diff --git a/deploy/huggingface/README.md b/deploy/huggingface/README.md
new file mode 100644
index 0000000..7e741fe
--- /dev/null
+++ b/deploy/huggingface/README.md
@@ -0,0 +1,10 @@
+# Hugging Face Space metadata
+
+The canonical Space card values live in `space-metadata.yml`. They belong in
+the YAML front matter at the top of the Hugging Face Space repository's root
+`README.md`.
+
+The GitHub repository README deliberately excludes that front matter because
+GitHub renders it as a metadata table above the project introduction. When
+publishing a Space, wrap `space-metadata.yml` in `---` delimiters and prepend it
+to the README copied into the Space repository.
diff --git a/deploy/huggingface/space-metadata.yml b/deploy/huggingface/space-metadata.yml
new file mode 100644
index 0000000..ccd5f5a
--- /dev/null
+++ b/deploy/huggingface/space-metadata.yml
@@ -0,0 +1,14 @@
+title: OBLITERATUS
+emoji: "💥"
+colorFrom: green
+colorTo: gray
+sdk: gradio
+sdk_version: "5.29.0"
+app_file: app.py
+persistent_storage: large
+pinned: true
+license: agpl-3.0
+tags:
+  - abliteration
+  - mechanistic-interpretability
+short_description: "One-click model liberation + chat playground"