docs/phase3_streamlit_demo.md

# Phase 3: Streamlit Demo Guide

## Goal

Phase 3 turns the modular KnowFlow AI RAG backend into an interactive Streamlit web app.

## Demo Flow

1. Start the Streamlit app.
2. Open the browser.
3. Check configuration in sidebar.
4. Test cloud API connection.
5. Confirm knowledge base files are visible.
6. Rebuild the knowledge base.
7. Ask demo questions.
8. Inspect retrieved source chunks.
9. Upload a new document.
10. Rebuild the knowledge base again.
11. Ask questions from the new document.

## Local URL

```text
http://localhost:8501

Main Features
Document upload
Knowledge base rebuild
Chat interface
Demo question buttons
Retrieved source expanders
Full RAG debug JSON
Model and vector database status
Output saving
Event logging
Production Notes

This Streamlit app is suitable for:

Portfolio demos
Recruiter demos
Internal prototypes
Hugging Face Spaces deployment

For larger production systems:

Move backend to FastAPI
Add authentication
Add user-specific document storage
Add database-backed chat history
Add monitoring
Add rate limiting