README.md

---
title: RecrAI Backend
emoji: 😻
colorFrom: green
colorTo: red
sdk: docker
pinned: false
---

# RecrAI — API (FastAPI + Groq) para Análise de Currículos

API que analisa CVs (PDF ou texto) contra uma vaga e retorna JSON estruturado (inclui `score`), pronta para rodar em Hugging Face Spaces via Docker.

## Endpoints

### GET /health
Retorna status da API.

### POST /analyze_cv (multipart/form-data)
Campos:
- `job` (string) — descrição completa da vaga (obrigatório)
- `cv_text` (string) — texto do currículo (opcional se `file` for enviado)
- `file` (file/pdf) — PDF do currículo (opcional se `cv_text` for enviado)

### POST /analyze_cv_batch (application/json)
```json
{
  "items": [
    { "job": "texto da vaga", "cv_text": "texto do cv" },
    { "job": "texto da vaga", "cv_pdf_b64": "<PDF em base64>" }
  ]
}