Simple Chatbot

Introduction

This repository presents a Simple Chatbot application powered by the DeepSeek-V3 model. Designed with a mix of CSS, JavaScript, Python, and HTML, it combines visually appealing design with intelligent conversational capabilities. The project exemplifies the seamless integration of AI-driven dialogue systems with a polished user experience.

Table of Contents

• Introduction
• Prerequirements
• Project Structure
• Model
• Features
• Installation
• How to get API Access Token
• Usage
• License

Prerequirements

• or above: Download here
• Hugging Face account: Sign up here

Project Structure

simple-chatbot/
├── static/
│   ├── css/
│   │   └── style.css
│   ├── script.js
│   └── icons...
├── templates/
│   └── index.html
├── .gitignore
├── app.py
├── requirements.txt
├── .env.example
├── LICENSE
└── README.md

Model

• deepseek-ai/DeepSeek-V3 (You can use different models)

Features

Respond to user questions.

Installation

To install this project, open your Terminal and follow these steps:

1. Clone the repository:

   $ git clone https://github.com/arthurtran04/simple-chatbot.git

2. Change the directory to simple-chatbot:

   $ cd "$(find . -type d -name "simple-chatbot")"

3. Create a Python virtual environment .venv and install the required dependencies:

   $ python3 -m venv .venv
   source .venv/bin/activate
   pip install -r requirements.txt

4. Set up environment variables:

   $ cp .env.example .env

5. Configure your .env file:

   # Hugging Face API Token
   API_TOKEN=

How to get API Access Token

1. Go to Hugging Face website, click your avatar and click "Access Tokens"

2. Click "Create new token"

3. Name your token and tick the two checkboxes in the "Inference" section

4. Scroll down and click "Create token"

5. Copy your Access Token before closing and paste it into the API_TOKEN variable inside the .env file

Usage

To start the application, run the app.py file:

$ python app.py

This application will run locally at http://127.0.0.1:5000:

The UI:

Enter your prompt in the textbox below, and the chatbot will respond:

To stop the application, use Ctrl + C in the Terminal

License

This project is licensed under the MIT License. See the LICENSE file for more details.