An open API service indexing awesome lists of open source software.

https://github.com/priom7/deepseek-react-chat-app

Run Deekseek LLM model locally with Ollama, deepseek-r1:1.5b, and React
https://github.com/priom7/deepseek-react-chat-app

Last synced: 4 days ago
JSON representation

Run Deekseek LLM model locally with Ollama, deepseek-r1:1.5b, and React

Awesome Lists containing this project

README

          

# 🛠️ React-Powered Local Chatbot with Ollama & DeepSeek LLM

## 🚀 Overview

This project is a real-time chatbot built with **React**, powered by **Ollama** running locally with the **DeepSeek LLM**. The entire application, including the LLM model, runs on your local machine, ensuring full control over data and performance.

## 🎯 Features

- 💬 **Real-time Chat** with AI responses
- 🤖 **DeepSeek LLM** model for intelligent conversations
- 🧠 **Thinking & Typing Indicators** for better UX
- 🌟 **Smooth Animations** using Framer Motion
- 🎨 **Bootstrap UI** for a modern chat interface
- 🏠 **Runs Fully Locally** – No external API calls required!

---

## ⚡ Setup Guide

### 1️⃣ Install & Set Up Ollama

To run the chatbot locally, you'll need **Ollama**, a lightweight LLM server.

#### 🛠️ Install Ollama

Download Ollama from the official website: 🔗 [https://ollama.com/](https://ollama.com/)

Follow the installation steps based on your OS:

- **Windows**: Run the installer
- **Mac**: Install via `brew install ollama`
- **Linux**: Follow the Linux-specific installation guide

#### 📥 Pull & Serve the DeepSeek Model

We are using **DeepSeek-r1:1.5b**. Pull and serve it with:

```bash
ollama pull deepseek-r1:1.5b
ollama serve
```

Once running, Ollama will be available at `http://127.0.0.1:11434/api/chat`.

---

### 2️⃣ Run the React App

#### 📦 Install Dependencies

Ensure you have **Node.js** and **npm** installed. Then, clone the repo and install dependencies:

```bash
git clone
cd
npm install
```

#### ▶️ Start the App

```bash
npm start
```

Your chatbot should now be running at `http://localhost:3000/`!

---

## 🔧 Configuration

- If you're using a different model, update the `model` parameter in `fetch` requests inside `ChatApp.js`.
- Modify UI elements using Bootstrap classes and Framer Motion for animations.

---

## 🎉 Enjoy chatting with your AI assistant, running entirely on your machine! 🚀


working gif