Trump Speeches NLP Chatbot — Documentation¶
A full-stack NLP platform combining retrieval-augmented generation, hybrid search, multi-model sentiment analysis, and AI-powered topic extraction. Built with FastAPI, ChromaDB, and pluggable LLM providers.
Quick Start¶
git clone https://github.com/JustaKris/Trump-Rally-Speeches-NLP-Chatbot.git
cd Trump-Rally-Speeches-NLP-Chatbot
uv sync
cp .env.example .env # Add your LLM_API_KEY
uv run uvicorn speech_nlp.app:app --reload
→ Full Quickstart Guide | Developer Guide (daily reference)
Live Demo¶
- Web App (Azure) — Interactive UI
- Swagger Docs — API playground
Note: Azure Free Tier hosting — cold starts take 1-5 minutes after inactivity. Once warmed, responses are fast.
The Three Features¶
| Feature | What It Does | Docs |
|---|---|---|
| Q&A System | RAG pipeline with hybrid search, guardrails, query rewriting, entity analytics, and confidence scoring | Reference |
| Sentiment Analysis | FinBERT + RoBERTa + LLM interpretation for political/emotional tone analysis | Reference |
| Topic Analysis | Semantic clustering with AI-generated labels, contextual snippets, and theme summaries | Reference |
Documentation Map¶
Guides — Quickstart · Deployment · CI/CD Local Testing · Documentation
Reference — Architecture · Configuration · FAQ
Development — Code Style · Testing · Linting · Security · Logging