DeepSeek WebUI

DeepSeek WebUI is a browser-based interactive chat interface that leverages DeepSeek R1 via the Ollama framework. This project consists of a React frontend (UI) and a Node.js backend (server) to facilitate real-time interactions with DeepSeek models, simulating a chat experience similar to Gemini and ChatGPT, including memory retention and bot typing effects.

Features

• Frontend (UI) - React:

  • Chat interface with a human-readable format for DeepSeek R1 responses.

  • Supports inline code, multi-line code blocks, headings, text styles, and more.

  • Streams responses in real time for a smooth chat experience.

  • Fetches responses from the backend using fetch API.

• Backend (Server) - Node.js:

  • Exposes an API endpoint for processing messages via Ollama.chat.

  • Streams bot responses for real-time typing effects.

  • Implements chat memory to maintain conversation context.

  • Supports custom DeepSeek models (default: deepseek-r1:7b).

Folder Structure

root/  
│-- server/ # Node.js backend (API server)  
│-- ui/ # React frontend (chat interface) 

Prerequisites

Before setting up DeepSeek WebUI, ensure you meet the following requirements:

• DeepSeek Model: Must be installed manually (refer to DeepSeek on Hugging Face).

• Ollama: Required to serve the model locally. Install from Ollama's official site.

• Hardware Requirements: (Minimum for deepseek-r1:7b)

  • CPU: 8-core (Intel i7-12700H recommended for smooth performance)

  • RAM: 16GB+ (Higher RAM improves performance)

  • Storage: SSD recommended for fast model loading

  • GPU: Recommended for faster inference (supports CUDA & ROCm acceleration)

Installation & Setup

1️⃣ Install Ollama

curl -fsSL https://ollama.com/install.sh | sh

or if you are using windows 11, download from https://ollama.com/

2️⃣ Download & Setup DeepSeek Model

ollama pull deepseek-r1:7b

(Or use deepseek-r1:1.5b for lower resource usage)

again if you're windows 11 user, you can simply runs ollama run deepseek-r1:7b on drive C:\ with admin permission. This will download the model r1:7b (around 4-5gb - only downloading once on setup) and then it will "serve" the ollama locally

3️⃣ Clone the Repository

git clone https://github.com/hernandack/deepseek-webui.git
cd deepseek-webui

4️⃣ Install & Run Backend (Node.js API Server)

cd server
npm install
npm install -g nodemon
nodemon server.js

Server will run on http://localhost:3000/

5️⃣ Install & Run Frontend (React UI)

cd ../ui
npm install
npm run dev

UI will run on http://localhost:5173/ (or the Vite default port)

Usage

1. Open the React UI in your browser.
2. Type a message and send it.
3. The response will stream in real-time.
4. The chat maintains conversation memory for better context understanding.
5. This is tested on Intel i7 12700H with 16GB ram and RTX3060 (CUDA) with very smooth experience

Customizing Model

By default, DeepSeek WebUI uses deepseek-r1:7b. To change the model, update server.js:

const stream = await ollama.chat({
    model: "deepseek-r1:7b",  // Change model here
    messages: [{ role: "user", content: message }],
    stream: true
});

Supported models:

• deepseek-r1:7b (recommended)
• deepseek-r1:1.5b (lower resource usage, but reduced performance)
• You can use higher model but it might need way higher resource than 7B

Contributing

I welcome contributions! If you find a bug or have an idea for improvement, feel free to open an issue or submit a pull request.

License

This project is open-source and available under the MIT License.

Enjoy real-time AI interactions with DeepSeek WebUI! --- Hernandack