Skip to content

Latest commit

Β 

History

History
102 lines (72 loc) Β· 2.42 KB

File metadata and controls

102 lines (72 loc) Β· 2.42 KB

🧠 Footprints Bot β€” AI Admission Assistant

πŸ”— Live Demo
Built using LangChain, OpenAI GPT-4, FastAPI, and React, Footprints Bot is an AI-powered assistant that helps parents explore preschool programs, ask questions, and schedule visits β€” all through natural multi-turn conversation.


πŸš€ Features

  • πŸ€– Conversational AI using LangChain Agents + OpenAI GPT
  • πŸ” Multi-turn reasoning with context tracking
  • 🧠 Intent classification for program, fee, visit, and safety queries
  • πŸ“ Center recommendations via city and locality filtering
  • πŸ“š FAQ routing through a structured knowledge base
  • πŸ” API key protection via .env file
  • πŸ—ƒ JSON-based data store (extensible to MongoDB)

πŸ—‚ Project Structure

footprints-chat/
β”œβ”€β”€ backend/
β”‚   β”œβ”€β”€ bot.py                # Core logic and prompt orchestration
β”‚   β”œβ”€β”€ centers.json          # Data for all Footprints centers
β”‚   β”œβ”€β”€ knowledge_base.py     # Structured FAQs
β”‚   β”œβ”€β”€ .env                  # API key config
β”‚   └── test.py               # Bot testing script
β”œβ”€β”€ frontend/
β”‚   β”œβ”€β”€ public/
β”‚   └── src/                  # Basic UI (optional)

βš™οΈ Getting Started

1. Clone the Repository

git clone https://github.com/priyanshusinghal12/Footprints-Bot.git
cd footprints-chat/backend

2. Install Requirements

pip install -r requirements.txt

3. Set Up Environment

Create a .env file in the backend folder:

OPENAI_API_KEY=your-openai-api-key-here

4. Run the Bot

python bot.py

πŸ’¬ Sample Interaction

πŸ‘€ Hi! I want to know about daycare programs.
πŸ€– Sure! We offer:
- Pre-School: 9 AM – 12 PM
- Full Day Care: 9 AM – 6:30 PM
- After School: 3:30 PM – 6:30 PM
All programs run Mon–Fri.

🌐 Deployment

  • Frontend: Hosted on Vercel
  • Backend API: Hosted on Render
  • Optional Docker support for future deployment

πŸ™Œ Acknowledgements


πŸ‘¨β€πŸ’» Author

Priyanshu Singhal
BSc Mathematics, University of Waterloo
πŸ“« psinghal@uwaterloo.ca Β· 🌐 LinkedIn