Upload README.md with huggingface_hub

README.md

@@ -1,3 +1,44 @@
----
-license: mit
----
+# BERT-Thetis: Geometric BERT Models
+
+This repository contains BERT-Thetis models with deterministic crystal embeddings.
+
+## 📁 Repository Structure
+
+```
+AbstractPhil/bert-thetis-tiny-wikitext103/
+├── bert-thetis-tiny-wikitext103/
+│   └── YYYY-MM-DD_HH-MM-SS/  (training run timestamp)
+│       ├── best/              (best validation checkpoint)
+│       ├── final/             (final checkpoint)
+│       └── step-N/            (intermediate checkpoints)
+```
+
+## 🌊 What is BERT-Thetis?
+
+BERT-Thetis replaces traditional learned embeddings with **deterministic crystal structures**:
+
+- **Beatrix Staircase Encodings**: Zero-parameter positional structure
+- **Character Composition**: Learnable semantic bridge  
+- **Crystal Inflation**: Deterministic 5-vertex simplex generation
+
+This reduces vocabulary parameters by ~95% while maintaining performance.
+
+## 🚀 Quick Start
+
+```python
+from geovocab2.train.model.core.bert_thetis import ThetisConfig, ThetisForMaskedLM
+
+# Load model
+config = ThetisConfig.from_pretrained("AbstractPhil/bert-thetis-tiny-wikitext103")
+model = ThetisForMaskedLM(config)
+```
+
+## 📚 Resources
+
+- **Repository:** [github.com/AbstractEyes/lattice_vocabulary](https://github.com/AbstractEyes/lattice_vocabulary)
+- **Author:** AbstractPhil
+
+---
+
+**Latest Run:** 2025-10-13_20-09-33  
+**Model Variant:** bert-thetis-tiny-wikitext103