How skarif1617-ops/shadowfox works
This is a Streamlit student study utility. A student selects one of four tasks, enters text, and submits it; the app validates the input, builds a task-specific prompt, streams a Groq model response, and displays the result or an error. The runtime evidence is concentrated in app.py; the four prompt behaviors are documented in the README and implemented as branches of build_prompt().
Main entry points: app.py Request handler
Components 13
Student interface
- Task and text UI
app.py - Streaming result display
app.py - Warnings and errors
app.py
Request workflow
- Request handler
app.py - Input validation
app.py - Task prompt builder
app.py - Note summary prompt
app.py - Quiz prompt
app.py - Answer improvement prompt
app.py - Concept explanation prompt
app.py
AI inference
- Response streamer
app.py
Other components
- Student
- Groq Chat API
Connections 13
- Student → Task and text UI: enters task and text
- Task and text UI → Request handler: submits
- Request handler → Input validation: validates
- Request handler → Task prompt builder: builds prompt
- Task prompt builder → Note summary prompt: selects for summary
- Task prompt builder → Quiz prompt: selects for quiz
- Task prompt builder → Answer improvement prompt: selects for improvement
- Task prompt builder → Concept explanation prompt: selects for explanation
- Request handler → Response streamer: requests generation
- Response streamer → Groq Chat API: streams completion request
- Response streamer → Streaming result display: yields chunks
- Request handler → Warnings and errors: shows failures
- Request handler → Task and text UI: shows validation warning