File size: 2,178 Bytes
ecacdf7
 
0e3abca
ecacdf7
 
4ec36ec
ecacdf7
0e3abca
ecacdf7
0e3abca
ecacdf7
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
---
title: DeepSeek-R1 WebGPU
emoji: 🧠🐳
colorFrom: red
colorTo: blue
sdk: docker 
pinned: false
app_port: 7860
license: apache-2.0
short_description: Small reasoning model running in browser 
thumbnail: >-
  https://huggingface.co/spaces/webml-community/deepseek-r1-webgpu/resolve/main/banner.png
---

# DeepSeek-R1 WebGPU

Next-generation reasoning model running entirely in your browser using WebGPU acceleration.

## System Requirements

- WebGPU-compatible browser 
- 6GB+ RAM recommended

## Features
- πŸš€ Runs entirely in browser using WebGPU acceleration
- 🧠 1.5B parameter reasoning model
- πŸ’­ Shows step-by-step reasoning process
- πŸ”’ LaTeX math support
- πŸŒ™ Dark mode support

## Getting Started

Follow the steps below to set up and run the application.

### 1. Clone the Repository

Clone the examples repository from GitHub:

```sh
git clone https://github.com/huggingface/transformers.js-examples.git
```

### 2. Navigate to the Project Directory

Change your working directory to the `deepseek-r1-webgpu` folder:

```sh
cd transformers.js-examples/deepseek-r1-webgpu
```

### 3. Install Dependencies

Install the necessary dependencies using npm:

```sh
npm i
```

### 4. Run the Development Server

Start the development server:

```sh
npm run dev
```

The application should now be running locally. Open your browser and go to `http://localhost:5173` to see it in action.

## Usage

1. Click "Load model" to download and initialize the model
2. Wait for model initialization to complete (~1-2 minutes)
3. Type your question or select an example
4. View the model's step-by-step reasoning

## Browser Compatibility

- βœ… Chrome 

## Troubleshooting

- **WebGPU Not Available**: Ensure you're using a compatible browser with WebGPU enabled
- **Out of Memory**: Try closing other browser tabs to free up GPU memory
- **Model Loading Fails**: Check your internet connection and try reloading

## License & Attribution

- Model: [DeepSeek-R1-Distill-Qwen-1.5B](https://huggingface.co/deepseek-ai/DeepSeek-R1-Distill-Qwen-1.5B) by DeepSeek AI
- Framework: [πŸ€— Transformers.js](https://github.com/huggingface/transformers.js)
- License: Apache 2.0