Skip to content

Ollama ChatBot is a blazing-fast, privacy-first AI chatbot built using the power of Ollama's local large language models and the robustness of the Django web framework

License

KavinsProjects/ChatBot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🤖 Ollama Chatbot – Django Web Application

Welcome to the Ollama Chatbot, a private AI-powered chatbot built using LLaMA 3.0 and Django. It runs no online using Ollama’s local LLM engine, making it fast, secure, and ideal for personal or experimental use.


🚀 Overview

This project combines:

  • ⚙️ Ollama (LLaMA 3.0) – Local LLM runtime for intelligent text generation
  • 🌐 Django – Backend framework to manage logic and routes
  • 🎨 HTML/CSS/JavaScript – For a lightweight frontend chat interface
  • 🐍 Python – The programming core of both backend and integration

Screenshot 2025-05-28 120053

🌟 Key Features

  • 📴 Runs 100% Offline – No API keys or internet required
  • 🔐 Private by Design – Your conversations never leave your device
  • Fast & Local – Powered by LLaMA 3.0 via Ollama
  • 🧩 Simple & Modular – Easy to extend with new features

📂 Project Structure

CHATBOT/
├── chat/
│   ├── templates/chat/           # HTML for chat UI
│   │   └── index.html
│   ├── migrations/
│   ├── __init__.py
│   ├── admin.py
│   ├── apps.py
│   ├── models.py
│   ├── urls.py
│   └── views.py
│
├── chatbot_project/              # Django project settings
│   ├── __init__.py
│   ├── asgi.py
│   ├── settings.py
│   ├── urls.py
│   └── wsgi.py
│
├── db.sqlite3                    # SQLite database
├── manage.py                     # Django management tool
└── myvenv/                       # Virtual environment

⚙️ Prerequisites

🪟 Windows Setup

✅ Install Python 3.10+

Download from python.org

✅ Install Ollama with LLaMA 3.0

  1. Visit https://ollama.com and download Ollama for Windows
  2. During setup, download the LLaMA 3.0 model
  3. After installation, run the following in CMD/PowerShell:
ollama run llama3

🔧 Getting Started

  1. Open the project folder in VS Code

  2. Create and activate a virtual environment

python -m venv myvenv
myvenv\Scripts\activate
  1. Install Django
pip install django
  1. Run database migrations
python manage.py migrate
  1. Start the Django development server
python manage.py runserver
  1. Run the LLaMA 3.0 model (in a separate terminal)
ollama run llama3
  1. Open your browser and go to:
    http://127.0.0.1:8000

🧠 How It Works

  • The user sends a message via the web chat interface
  • Django captures the message and sends it to the local Ollama API
  • LLaMA 3.0 processes the message and returns a response
  • The response is displayed back in the browser

📜 License

This project is licensed under the MIT License.


Powered by LLaMA 3.0 via Ollama

About

Ollama ChatBot is a blazing-fast, privacy-first AI chatbot built using the power of Ollama's local large language models and the robustness of the Django web framework

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published