Skip to content

SEDENYS/denys-chatbot

Repository files navigation

🤖 Denys ChatBot

Smart AI Chat Assistant built with Nuxt, TypeScript & OpenAI Assistants API


💡 Overview

Denys ChatBot is a lightweight and customizable AI chat application built with Nuxt 3 + TypeScript and powered by the OpenAI Assistants API.
It’s designed for scenarios where the chatbot should respond only based on specific, provided information — such as uploaded documents, text files, or structured data.

Perfect for:

  • 🧭 Customer Support — bots that answer based on company documentation
  • 💼 Internal Knowledge Bases — assistants for employees and internal tools
  • 👤 Personal Portfolio Assistants — bots that represent you and your projects
  • 🧪 Domain-Specific Experts — assistants for IT, education, healthcare, law, and more

🧠 Core Features

  • 📂 File-based Knowledge — the bot responds only using uploaded content (PDF, TXT, MD, etc.)
  • 🗣️ Context-Aware Responses — accurate and relevant answers using local context
  • 💬 Responsive Chat UI — modern and clean Nuxt 3 interface
  • 🧩 Plug & Play Architecture — easily integrates into any project
  • 🔐 Secure API Layer — communication via OpenAI Assistants API
  • 🌍 Multi-Purpose Use — adaptable to any business or personal use case

⚙️ Tech Stack

  • Frontend: Nuxt 3, TypeScript, Tailwind CSS
  • Backend: OpenAI Assistants API
  • Environment: dotenv (.env.local)
  • Deployment: Vercel / Node-compatible hosting

⚡ How It Works

graph TD
A[User] -->|Types a message| B[Nuxt Chat UI]
B -->|Sends request| C[/Server API Route/]
C -->|Calls| D[OpenAI Assistants API]
D -->|Retrieves context from uploaded file| E[Knowledge Base]
E -->|Generates accurate reply| F[Chat Response]
F -->|Returns message| B
Loading
  1. The user sends a message through the chat interface.
  2. The frontend (Nuxt) sends a request to a server API route.
  3. The API route communicates with the OpenAI Assistants API, passing the context from the uploaded file.
  4. The assistant searches only within the file’s content (knowledge base).
  5. A precise answer is generated and returned to the chat interface.

🚀 Getting Started

1️⃣ Clone the repository

git clone [email protected]:SEDENYS/denys-chatbot.git
cd denys-chatbot

2️⃣ Install dependencies

npm install

3️⃣ Set up environment variables

Create a .env.local file in the project root and add:

OPENAI_API_KEY=your_api_key_here

4️⃣ Run the development server

npm run dev

5️⃣ Open in browser

👉 http://localhost:3000


🧩 Future Plans

  • 🧠 Support multiple files as a knowledge base
  • 🔄 Add conversation memory across sessions
  • 🪄 Custom UI themes (dark/light/system)
  • 🎙️ Voice input & speech output integration
  • 📊 Admin dashboard for analytics and usage tracking

📜 License

MIT © 2025 — Denys ChatBot

About

ChatBot with Nuxt, TypeScript and the OpenAI Assistants API

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors