Spaces:
Running
Running
File size: 1,501 Bytes
7b5b134 3a2bd87 7b5b134 3a2bd87 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 | ---
title: CortexFlow Backend
emoji: 🧠
colorFrom: blue
colorTo: indigo
sdk: docker
app_port: 7860
pinned: false
---
# Backend
FastAPI backend service for CortexFlow.
Joint collaboration repository by the MA2TIC group.
Private codebase. Licensing context is defined in [../LICENSE](../LICENSE).
## Design Profile
- Deterministic feature extraction from transcript and pause signals
- Confidence and quality notes for low-evidence samples
- Non-diagnostic safety framing in generated output
- Groq model usage limited to narrative/safety language, not synthetic metric creation
## API Endpoints
- `GET /health`
- `GET /models/recommended`
- `POST /analyze`
`POST /analyze` payload shape:
```json
{
"input_value": "optional text input",
"transcript": "optional transcript input",
"pause_map": [0.32, 0.45],
"audio_duration": 24.8,
"session_id": "optional"
}
```
Response format: streamed NDJSON with step and final events.
## Hugging Face Spaces (Docker)
Hosting target: Docker Space.
Deployment profile:
- Repository root in Space contains backend files (`main.py`, `requirements.txt`, `Dockerfile`, supporting modules)
- Required secret: `GROQ_API_KEY`
- Container runtime binds to `${PORT}` (default fallback configured in Dockerfile)
- Health probe endpoint: `GET /health`
## Local Development Reference
```bash
cd backend
python -m venv .venv
. .venv/Scripts/Activate.ps1
pip install -r requirements.txt
copy .env.example .env
uvicorn main:app --reload --port 8000
```
|