drbh HF Staff commited on
Commit
2ecd91a
·
verified ·
1 Parent(s): d4c38b4

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +49 -36
README.md CHANGED
@@ -7,40 +7,53 @@ sdk: static
7
  pinned: false
8
  ---
9
 
 
 
 
 
 
 
10
  # Kernels Community
11
- 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.
12
-
13
- 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.
14
-
15
- ## Projects
16
- The kernel hub team maintains two projects to make interacting with the kernel hub as easy as possible.
17
- <div style="display: flex; flex-direction: column; gap: 20px; flex-wrap: wrap; margin-bottom: 20px;">
18
- <a href="https://github.com/huggingface/kernel-builder" style="flex: 1; min-width: 250px; text-decoration: none; color: inherit;">
19
- <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;">
20
- <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;">
21
- <div>
22
- <h3>kernel-builder</h3>
23
- <p>Creates compliant kernels that meet strict criteria for portability and compatibility.</p>
24
- </div>
25
- </div>
26
- </a>
27
-
28
- <a href="https://huggingface.co/docs/kernels/" style="flex: 1; min-width: 250px; text-decoration: none; color: inherit;">
29
- <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;">
30
- <img src="https://github.com/user-attachments/assets/64a652f3-0cd3-4829-b3c1-df13f7933569" width="80" height="80" alt="kernel logo" style="margin-right: 16px;">
31
- <div>
32
- <h3>kernels</h3>
33
- <p>Python library to load compute kernels directly from the Hub.
34
- </div>
35
- </div>
36
- </a>
37
- </div>
38
-
39
- ## What are Compliant Kernels?
40
-
41
- Kernels on the Hub are designed to be:
42
- - **Portable**: Load from paths outside `PYTHONPATH`
43
- - **Unique**: Multiple versions can run in the same process
44
- - **Compatible**: Support various Python versions, PyTorch builds, and C++ ABIs
45
-
46
- Learn more about Kernel Hub and kernels library [in this blog](https://huggingface.co/blog/hello-hf-kernels).
 
 
 
 
 
 
 
 
7
  pinned: false
8
  ---
9
 
10
+ <img
11
+ src="https://github.com/user-attachments/assets/4b5175f3-1d60-455b-8664-43b2495ee1c3"
12
+ alt="Kernels Community"
13
+ width="200"
14
+ />
15
+
16
  # Kernels Community
17
+
18
+ The **Kernel Hub** allows Python libraries and applications to **load optimized compute kernels directly from the Hugging Face Hub**.
19
+
20
+ You can think of it as the Model Hub, but for low-level, high-performance code (kernels) that accelerate specific operations, often on GPUs.
21
+
22
+ Instead of manually managing complex dependencies, dealing with compilation flags, or building libraries like Triton or CUTLASS from source, the `kernels` library lets you fetch and run **pre-compiled, optimized kernels** on demand.
23
+
24
+ ---
25
+
26
+ ## Repos
27
+
28
+ The Kernel Hub team maintains two core repos:
29
+
30
+ ### `kernels`
31
+
32
+ The main repository containing:
33
+ - A deterministic kernel builder
34
+ - A Python library for loading and executing kernels
35
+
36
+ Documentation:
37
+ https://huggingface.co/docs/kernels/
38
+
39
+ ### `kernels-community`
40
+
41
+ A repository that contains the source code for all of the kernels-community kernels
42
+
43
+ Source code:
44
+ https://github.com/huggingface/kernels-community
45
+
46
+ ---
47
+
48
+ ## Compliant Kernels
49
+
50
+ Kernels published on the Hub are designed to be:
51
+
52
+ - **Portable** loadable from paths outside `PYTHONPATH`
53
+ - **Isolated** — multiple kernel versions can run in the same process
54
+ - **Compatible** — support different Python versions, PyTorch builds, and C++ ABIs
55
+
56
+ ---
57
+
58
+ Learn more about the Kernel Hub and the `kernels` library by reading the docs:
59
+ https://huggingface.co/docs/kernels/index