diff --git a/README.md b/README.md
index ae18985..01d73e9 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,34 @@
-# jetson
+# 🌮 Jetson TacoStand: Modular ML Automation with Flavor
 
-just a test repo
\ No newline at end of file
+
+Welcome to the Jetson TacoStand—where machine learning meets modular automation, wrapped in crispy reproducibility and saucy branding.
+
+## 🌯 Project Overview
+
+This repo contains the scaffolding for a scalable ML pipeline running on Jetson Nano nodes. It integrates:
+
+- 🧠 Jupyter notebooks for model training and experimentation
+- 🐙 Gitea for version control and SSH-based repo management
+- 🐳 Docker containers for reproducible environments
+- 🔁 Automated retraining and deployment workflows
+- 📊 Prometheus hooks (coming soon) for observability
+
+## 🌮 Features
+
+- Modular repo layout with clean separation of notebooks, configs, and scripts
+- SSH key-based Git workflows for secure, seamless updates
+- Dockerized HandBrake containers for media post-processing
+- Integrated Sonarr/Radarr pipelines for automated transcoding
+- ASCII branding and taco-themed README for maximum flavor
+
+## 📁 Repo Structure
+
+```bash
+jetson-tacostand/
+├── notebooks/           # Jupyter workflows
+├── docker/              # Container configs
+├── scripts/             # Automation scripts
+├── branding/            # ASCII art, logos, README assets
+├── .gitignore
+├── README.md
+└── LICENSE