README.md

metadata

title: Maria Learning Service
emoji: 📚
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 5.9.1
app_file: app.py
pinned: false
license: mit

Maria Learning Service

A FastAPI-based AI tutoring service powered by Qwen3.5-2B (4-bit quantized) with ZeroGPU.

Endpoint

POST /chat — Main tutoring endpoint
GET /health — Health check

Authentication

Pass one of these headers per request:

Header	Description
auth_code	Raw value whose SHA-256 must match HASH_VALUE secret
cf-turnstile-token	Cloudflare Turnstile token verified against CF_SECRET_KEY secret

Secrets Required

Set these in your Space → Settings → Secrets:

• HASH_VALUE — SHA-256 hex digest of your auth code
• CF_SECRET_KEY — Cloudflare Turnstile secret key