How gargi-09/f1-tax-assistant works
F-1 Tax Assistant is a Flask-backed conversational prototype for helping international students understand common U.S. tax filing questions. A student submits a question through the chat UI; the backend chooses an AI response when configured or a keyword-matched demo response otherwise, then returns guidance for display with confidence and source details. Separate UI tools support treaty lookup, form selection, glossary, and verification. The README documents these capabilities, but excerpts do not show all route implementations, so some UI-to-backend links rely on documented endpoints or are omitted.
Main entry points: script.js Chat and tools · app.py Flask app · index.html Chat interface
Components 14
Student interface
- Chat interface
templates/index.html - Chat and tools
static/js/script.js - Treaty lookup
static/js/script.js - Form wizard
static/js/script.js - Trust and advisor UI
static/js/script.js
Tax guidance
- Flask app
app.py - Scenario responses
app.py - Tax reference data
app.py - Confidence details
app.py
Response services
- Keyword matching
app.py - AI response
app.py
Other components
- F-1 student
- Gemini API
- OpenAI API
Connections 16
- F-1 student → Chat interface: asks question
README.md - Chat interface → Chat and tools: submits input
static/js/script.js - Chat and tools → Flask app: posts message
static/js/script.js - Flask app → Chat and tools: returns response
app.py - Chat and tools → Chat interface: renders answer
static/js/script.js - Flask app → Keyword matching: selects when no AI
app.py - Flask app → AI response: selects when enabled
app.py - Keyword matching → Scenario responses: matches keywords
app.py - AI response → Gemini API: requests generation
app.py - AI response → OpenAI API: may use provider
README.md - Chat and tools → Treaty lookup: opens lookup
static/js/script.js - Treaty lookup → Flask app: fetches treaty data
static/js/script.js - Chat and tools → Form wizard: opens wizard
static/js/script.js - Chat and tools → Trust and advisor UI: shows verification
static/js/script.js - Trust and advisor UI → Confidence details: loads confidence
static/js/script.js - Chat and tools → Tax reference data: shows tax details