README_HF.md

metadata

title: UA Student Navigator Chatbot
emoji: 🎓
colorFrom: blue
colorTo: purple
sdk: streamlit
sdk_version: 1.28.0
app_file: app.py
pinned: false
license: mit

🎓 UA Student Navigator Chatbot

A web-retrieval + summarization agent that answers University of Arizona (UA) student questions using only official UA webpages and always shows sources.

Features

• 🔍 SearXNG Integration: Searches UA domains (arizona.edu and subdomains)
• 📄 Full Page Reading: Fetches and extracts complete content from webpages
• 🤖 OpenRouter Integration: Access to 30+ free, open-source models
• 🕰️ Wayback Machine: Automatic fallback for blocked pages
• 🕷️ Controlled Crawling: Optionally crawls internal links from user-provided URLs
• 📊 Evidence-Based: All answers are grounded in extracted evidence with citations
• 🚫 No Hallucinations: Explicitly states when information is not found
• ⚡ Rate Limit Management: Smart rate limiting with partial results

Getting Started

1. Get an OpenRouter API Key (free at https://openrouter.ai)
2. Enter your API key in the sidebar
3. Select a model from the dropdown (30+ free models available)
4. Ask questions about University of Arizona!

Usage

Search Query

Ask questions like:

• "What campus resources are available?"
• "What are the housing deadlines?"
• "What majors are in the College of Science?"

Website URL

Analyze specific UA webpages by providing a URL and what you're looking for.

Available Models

The app automatically loads free, open-source models including:

• xiaomi/mimo-v2-flash:free - 262K context
• deepseek/deepseek-r1-0528:free - 163K context, reasoning
• openai/gpt-oss-20b:free - 131K context
• And many more!

Rate Limits

The app automatically manages rate limits and will show partial results if limits are reached. Try different models if one is rate-limited.

Privacy

• All API keys are stored locally in your session
• No data is stored or logged
• All searches are limited to arizona.edu domains

License

MIT License - See LICENSE file for details