Upload README.md with huggingface_hub

README.md

@@ -0,0 +1,111 @@
+---
+license: apache-2.0
+tags:
+  - geofractal-router
+  - collective-intelligence
+  - math-reasoning
+  - multi-stream
+  - emergence
+  - routing
+datasets:
+  - openai/gsm8k
+base_model:
+  - tbs17/MathBERT
+  - google-t5/t5-base
+pipeline_tag: text-classification
+---
+
+# Math Collective - Galaxy Brain Router
+
+**6-stream collective intelligence system for mathematical reasoning.**
+
+## Architecture
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    GALAXY BRAIN COLLECTIVE                   │
+├─────────────────────────────────────────────────────────────┤
+│  FUZZY STREAMS (learned representations)                    │
+│  ├── MathBERT (frozen) → Head A → "symbolic understanding"  │
+│  └── T5-base (frozen)  → Head B → "linguistic reasoning"    │
+│                                                             │
+│  DETERMINISTIC STREAMS (pure computation)                   │
+│  ├── Eigenspectrum    → Head C → "covariance geometry"      │
+│  ├── Cayley-Menger    → Head D → "distance geometry"        │
+│  ├── Symbolic Calc    → Head E → "actual arithmetic"        │
+│  └── Fractal Dim      → Head F → "complexity measure"       │
+│                                                             │
+│  All 6 streams → Fusion → Classifier                        │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## Key Innovation
+
+**Fuzzy + Deterministic Routing**
+
+The router learns WHEN to trust each stream:
+- Simple arithmetic? Trust the Symbolic Calculator (deterministic)
+- Complex word problem? Trust MathBERT/T5 (semantic)
+- Ambiguous? Triangulate across all 6 perspectives
+
+## Streams
+
+| Stream | Type | Source | Purpose |
+|--------|------|--------|---------|
+| MathBERT | Fuzzy | tbs17/MathBERT (frozen) | Mathematical notation understanding |
+| T5-base | Fuzzy | t5-base (frozen) | General language reasoning |
+| Eigenspectrum | Deterministic | Covariance eigenvalues | Geometric structure of embeddings |
+| Cayley-Menger | Deterministic | Distance matrix geometry | Simplex volume features |
+| Symbolic | Deterministic | Regex + arithmetic | Actual number extraction & computation |
+| Fractal | Deterministic | Correlation dimension | Problem complexity measure |
+
+## Training
+
+- **Dataset**: GSM8K (Grade School Math 8K)
+- **Task**: Answer magnitude bucket prediction (20 buckets)
+- **Frozen params**: ~330M (MathBERT + T5)
+- **Trainable params**: ~15M (routing heads, fusion, projections)
+
+## Emergence Metric (ρ)
+```
+ρ = collective_accuracy / max(individual_accuracies)
+
+ρ > 1.0 = emergence (collective outperforms best individual)
+```
+
+## Usage
+```python
+from huggingface_hub import hf_hub_download
+import torch
+
+# Download checkpoint
+checkpoint_path = hf_hub_download(
+    repo_id="AbstractPhil/math_collective",
+    filename="checkpoints/checkpoint_epoch_5.pt"
+)
+
+# Load and use (see geofractal-router for full implementation)
+checkpoint = torch.load(checkpoint_path)
+print(f"Epoch: {checkpoint['epoch']}")
+print(f"Metrics: {checkpoint['metrics']}")
+```
+
+## Related
+
+- **Framework**: [AbstractPhil/geofractal_router](https://huggingface.co/AbstractPhil/geofractal_router)
+- **Paper**: Coming soon
+- **Code**: [GitHub - geofractal](https://github.com/AbstractEyes/geofractal)
+
+## Citation
+```bibtex
+@misc{abstractphil2025mathcollective,
+  title={Math Collective: Galaxy Brain Routing for Mathematical Reasoning},
+  author={AbstractPhil},
+  year={2025},
+  publisher={Hugging Face},
+  url={https://huggingface.co/AbstractPhil/math_collective}
+}
+```
+
+## License
+
+Apache 2.0