Skip to content

README.md

Latest commit

 

History

History
114 lines (77 loc) · 1.77 KB

README.md

File metadata and controls

114 lines (77 loc) · 1.77 KB

Aether AI Chatbot

A modern full-stack AI chatbot built with a responsive conversational UI, persistent chat history, and backend AI processing.

Designed for real-world customer support use cases such as billing help, account queries, and technical assistance.

🚀 Features

  • Clean and well structured interface
  • Persistent conversations stored locally
  • Markdown-formatted AI responses
  • FastAPI backend with AI model integration
  • Scroll management and message streaming UX
  • Sidebar conversation management
  • Fully responsive layout (desktop, tablet, mobile)

🛠 Tech Stack

Frontend

  • React + TypeScript
  • TailwindCSS
  • Framer Motion
  • React Markdown

Backend

  • FastAPI (Python)
  • AI model API integration
  • History trimming for token control

📦 Local Setup

1. Clone the repository

git clone <your-repo-url>
cd <repo-name>

2. Backend setup

cd backend
python -m venv venv
venv\Scripts\activate   # Windows
pip install -r requirements.txt
uvicorn app.main:app --reload

Backend runs at:

http://127.0.0.1:8000

3. Frontend setup

cd frontend
npm install
npm run dev

Frontend runs at:

http://localhost:5173

🔐 Environment Variables

Create a .env file inside the backend folder:

GEMINI_API_KEY=your_api_key_here

Never commit this file to GitHub.

📁 Project Structure

frontend/        → React UI
backend/         → FastAPI server
services/        → API + storage logic
routes/          → Backend endpoints

🧠 Future Scope

  • Authentication & user accounts
  • Database chat storage
  • Streaming AI responses
  • Industry-specific AI fine-tuning
  • Production deployment pipeline

📄 License

For learning and demonstration purposes.