armanashrafansari/ai_chatbot

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

🤖 AI Chatbot with Gemini & OpenAI Agents

An AI chatbot project powered by Google Gemini and OpenAI models using an agentic framework. Built with FastAPI and Chainlit, containerized using Docker, managed with `uv`, and deployed via Hugging Face Spaces.

🟢 Live App: Demo <p align="center"> <img src="public/PROJECT_UI.jpg" alt="Project Logo" /> </p>

🚀 Features

• —🌐 Chainlit-powered web UI with starter prompts
• —🧠 Agent-based logic using OpenAI SDK + Gemini models
• —⚡ FastAPI backend for API flexibility
• —🎨 Styled with custom.css for a clean UI
• —🐳 Docker-ready for consistent environments
• —☁️ Deployable on Hugging Face Spaces Hey, Cortana. ---

🧩 Tech Stack

⚙️ Setup Instructions

1. Clone the Repository

git clone https://github.com/arman229/ai_chatbot.git
cd ai_chatbot

2. Create a Virtual Environment

Using `uv`:

uv venv
.venv\Scripts\activate
uv pip install pyproject.toml

3. Configure Environment

Create a .env file in the root directory:

GEMINI_API_KEY=your_gemini_api_key_here

4. Run Locally

Start FastAPI backend:

uvicorn chatbot.main:app --reload

Access it at: http://localhost:8000

🐳 Docker Usage

Build the Image

docker build -t ai_chatbot .

Run the Container

docker run -p 8000:8000  ai_chatbot

🚀 Deployment on Hugging Face

1. 1.Create a new Space on Hugging Face.
2. 2.Choose "Docker" as the runtime.
3. 3.Connect your GitHub repo or manually upload your project.
4. 4.Hugging Face will automatically build and deploy your app.