feat: update readme

README.md

@@ -1,5 +1,5 @@
 ---
-title: README
+title: Kernel Community
 emoji: 🔥
 colorFrom: gray
 colorTo: green
@@ -7,4 +7,37 @@ sdk: static
 pinned: false
 ---
 
-Edit this `README.md` markdown file to author your organization card.
+# Kernel Community
+The Kernel Hub allows Python libraries and applications to **load optimized compute kernels directly from the Hugging Face Hub**. Think of it like the Model Hub, but for low-level, high-performance code snippets (kernels) that accelerate specific operations, often on GPUs. 
+Instead of manually managing complex dependencies, wrestling with compilation flags, or building libraries like Triton or CUTLASS from source, you can use the `kernels` library to instantly fetch and run pre-compiled, optimized kernels.
+
+## Projects
+The kernel hub team maintains two projects to make interacting with the kernel hub as easy as possible.
+<div style="display: flex; gap: 20px; flex-wrap: wrap; margin-bottom: 20px;">
+  <a href="https://github.com/huggingface/kernel-builder" style="flex: 1; min-width: 250px; text-decoration: none; color: inherit;">
+    <div style="height: 160px; border: 1px solid #ddd; border-radius: 8px; padding: 8px; background-color: inherit; box-shadow: 0 4px 6px rgba(0,0,0,0.1); display: flex; flex-direction: row; align-items: center;">
+      <img src="https://github.com/user-attachments/assets/4b5175f3-1d60-455b-8664-43b2495ee1c3" width="80" height="80" alt="kernel-builder logo" style="margin-right: 16px;">
+      <div>
+        <h3>kernel-builder</h3>
+        <p>Creates compliant kernels that meet strict criteria for portability and compatibility.</p>
+      </div>
+    </div>
+  </a>
+  
+  <a href="https://github.com/huggingface/kernels" style="flex: 1; min-width: 250px; text-decoration: none; color: inherit;">
+    <div style="height: 160px; border: 1px solid #ddd; border-radius: 8px; padding: 8px; background-color: inherit; box-shadow: 0 4px 6px rgba(0,0,0,0.1); display: flex; flex-direction: row; align-items: center;">
+      <img src="https://github.com/user-attachments/assets/64a652f3-0cd3-4829-b3c1-df13f7933569" width="80" height="80" alt="kernel logo" style="margin-right: 16px;">
+      <div>
+        <h3>kernels</h3>
+        <p>Python library to load compute kernels directly from the Hub.
+      </div>
+    </div>
+  </a>
+</div>
+
+## What are Compliant Kernels?
+Kernels on the Hub are designed to be:
+- **Portable**: Load from paths outside `PYTHONPATH`
+- **Unique**: Multiple versions can run in the same process
+- **Compatible**: Support various Python versions, PyTorch builds, and C++ ABIs
+The Hub hosts both compliant and non-compliant kernels, but compliant ones (built with kernel-builder) offer support on a wide range of hardware.