Youssif-Ahmed/Digilians-Auditing-System

Instructor Attendance System

Docker-ready Hugging Face Space for the attendance and auditing system.

Project Structure

Digilians_Auditing_System/
|- app/
|  |- backend/
|  |- frontend/
|  |- requirements.txt
|- Dockerfile
|- README.md
|- .dockerignore
|- .gitignore

Required Space Secrets

Add these in the Hugging Face Space settings:

• —SUPABASE_URL
• —SUPABASE_SERVICE_ROLE_KEY
• —ENCRYPT_KEY

GitHub To Space Deploy

This repository includes a GitHub Actions workflow at .github/workflows/deploy-huggingface-space.yml.

Set these in your GitHub repository settings:

• —Repository variable: HF_SPACE_ID
• —Repository secret: HF_TOKEN

HF_SPACE_ID should be in the form owner/space-name.

Important for your case:

• —If the Space is under your friend's personal Hugging Face account, the token used in HF_TOKEN usually needs to be your friend's token because personal repos are owner-controlled.
• —If the Space is under a Hugging Face organization, a token from any member with write access can push updates.

After that, every push to the main branch will sync this repo to the Hugging Face Space.

Local Docker Run

docker build -t instructor-attendance-system .
docker run -p 7860:7860 \
  -e SUPABASE_URL=your_supabase_url \
  -e SUPABASE_SERVICE_ROLE_KEY=your_service_role_key \
  -e ENCRYPT_KEY=your_fernet_key \
  instructor-attendance-system

Then open http://localhost:7860.

Notes

• —The frontend is served by FastAPI from app/frontend.
• —API requests use the same deployed domain via /api/....
• —The health endpoint is available at /health.