CoolFace
Apppublic

audeh/abwaab-reports

sourceHugging Faceupdated 2mo agoView on Hugging Face
0likes
App README

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)

  1. 1.Put your key in .env: ANTHROPIC_API_KEY=sk-ant-...
  2. 2.Needs Homebrew libs: brew install ffmpeg poppler pango (already installed on this Mac).

Web app (recommended)

bash
./run.sh

Open 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)

bash
set -a; . .env; set +a
./.venv/bin/python make_reports.py Report_Tool_Template.xlsx --model sonnet

Outputs 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.