PatrickNgare/Tembo-ai

Tembo AI Kenya Travel Assistant # 🐘 Tembo AI — Kenya Travel Assistant An AI-powered travel assistant for Kenya with a beautiful React frontend and a fully free tech stack. **🚀 Live Demo:** tembo-ai-frontend.onrender.… --- ## ✨ Features - 🦁 **Smart RAG Pipeline** — Retrieval-augmented generation for accurate Kenya travel info - 💬 **Conversational AI** — Personalized responses with Swahili flair - 🎨 **Beautiful UI** — Modern React + Tailwind CSS frontend with animations - ⚡ **Real-time Typing Effect** — Character-by-character response display - 🏷️ **Category Filters** — Filter by Safari, Beaches, Culture, Transport - 📊 **Source Attribution** — See which documents informed each answer - 🆓 **100% Free Stack** — Cohere embeddings + Groq LLM + Supabase --- ## 🛠️ Tech Stack | Component | Technology | |-----------|------------| | **Frontend** | React + Tailwind CSS | | **Backend** | FastAPI (Python) | | **Embeddings** | Cohere `embed-english-light-v3.0` (free tier) | | **LLM** | Groq `llama-3.3-70b-versatile` (free tier) | | **Vector DB** | PostgreSQL + pgvector (Supabase) | | **Hosting** | Render (free tier) | --- ## 🚀 Quick Start ### Backend ```bash # Clone the repo git clone github.com cd tembo-ai # Create virtual environment python -m venv venv source venv/bin/activate # Windows: venv\Scripts\activate # Install dependencies pip install -r requirements.txt # Set up PostgreSQL with pgvector psql -U postgres -f setup_vector.py # Run SQL commands to create tables # Set up environment variables cp .env.example .env # Edit .env and add your API keys # Populate the knowledge base python massive_kenya_data.py # Or: python scrape_kenya_data.py # Run the server uvicorn main:app --reload ``` ### Frontend ```bash cd frontend npm install npm run dev ``` - **Backend API**: `localhost` - **Frontend UI**: `localhost` - **API Docs**: `localhost` --- ## 📁 Project Structure ``` tembo-ai/ ├── main.py …