audeh/abwaab-reports
Abwaab Report Generator
Turns tutoring recording links + fields into bilingual (Arabic + English) lesson-report PDFs. Everything runs locally except one Claude API call per report.
Setup (once)
- Put your key in
.env:ANTHROPIC_API_KEY=sk-ant-... - Needs Homebrew libs:
brew install ffmpeg poppler pango(already installed on this Mac).
Web app (recommended)
./run.shOpen http://localhost:5050 → add rows (or upload a sheet) → pick a model → Generate. Watch live per-report progress; download each PDF or all as a zip.
Command line (batch)
set -a; . .env; set +a
./.venv/bin/python make_reports.py Report_Tool_Template.xlsx --model sonnetOutputs land in output/ (per-report PDFs + merged ALL.pdf + run_summary.csv).
Sheet columns
Recording Link · Student Name EN · Student Name AR · Grade · Subject · Curriculum · Date · Time · Duration (min) · Tutor EN · Tutor AR · Model
Models
haiku (cheapest) · sonnet (recommended) · opus (best) — switch in the UI dropdown or --model.
Pieces
app.py web UI · pipeline.py per-report pipeline · gen_content.py Claude call · safecrop.py face-safe screenshot · render.py PDF · make_reports.py CLI.
