Chat SDK

AIChatbot is a blazing-fast, open-source chatbot template powered by FastAPI, React, and a custom knowledge base with staff approval functionality.

Features · Tech Stack · Deploy Your Own · Running Locally · License

🧠 Features

• FastAPI backend – Ultra-fast API built in Python
• React frontend – Clean UI with Tailwind CSS
• Knowledge base system – Pulls responses from pre-fed data
• Staff approval – Human-in-the-loop moderation for quality control
• Fully modular – Easily extend with new features or APIs

---

🧱 Tech Stack

• ⚙️ Backend: FastAPI (Python)
• 💻 Frontend: React, TypeScript, Tailwind CSS
• 💾 Database: SQLite / Postgres
• 🐳 Deployment: Docker & Docker Compose ready
• 🔐 Security: .env configuration & API Key handling

---

🚀 Deploy Your Own

You can deploy your own AIChatbot with Docker:

docker-compose up --build

Or deploy manually via Vercel, Railway, Render, or any backend hosting of your choice. Be sure to set the proper environment variables as seen in .env.example.

---

🛠 Running Locally

1. Clone the project

git clone https://github.com/KelvinCode1234/ai-chatbot
cd ai-chatbot

2. Backend setup

cd backend
python -m venv venv
source venv/bin/activate  # For Windows: venv\Scripts\activate
pip install -r requirements.txt

Set up your .env file:

DATABASE_URL=sqlite:///./bot.db
API_KEY=your_api_key_here

Start the backend:

uvicorn main:app --reload

---

3. Frontend setup

cd frontend
npm install
npm run dev

Visit http://localhost:3000 to access the chatbot.

---

📁 Project Structure

ai-chatbot/
│
├── backend/          # FastAPI app
│   ├── main.py
│   ├── models/
│   ├── routes/
│   └── utils/
│
├── frontend/         # React app
│   ├── src/
│   └── public/
│
├── docker-compose.yml
└── README.md

---

📜 License

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

---

🙏 Acknowledgements

• Inspired by pkaramagi/aichatbot
• Built by KelvinCode1234 with ❤️