README.md

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