🛠️ 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/

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:

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:

git clone <repo-url>
cd <project-directory>
npm install

▶️ Start the App

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! 🚀