VsCode commited on
Commit
56df22b
·
1 Parent(s): 2c9f880

essential stuffs for API

Browse files
Files changed (2) hide show
  1. API_README.md +74 -0
  2. requirements.txt +5 -3
API_README.md ADDED
@@ -0,0 +1,74 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # CareLink Medical - API de Análise de Exames
2
+
3
+ API FastAPI para análise de exames médicos usando IA (Google MedGemma).
4
+
5
+ ## 🚀 Funcionalidades
6
+
7
+ - ✅ Upload de imagens de exames médicos
8
+ - ✅ Análise automática com IA (MedGemma 4B)
9
+ - ✅ Retorno de análise estruturada em JSON
10
+ - ✅ Suporte a CORS para integração com frontend
11
+ - ✅ Documentação interativa (Swagger/OpenAPI)
12
+ - ✅ Health check endpoint
13
+
14
+ ## 📦 Instalação
15
+
16
+ ```bash
17
+ # Instalar dependências
18
+ pip install -r requirements.txt
19
+
20
+ # Fazer login no Hugging Face
21
+ huggingface-cli login
22
+ ```
23
+
24
+ ## 🏃 Executar
25
+
26
+ ```bash
27
+ uvicorn app:app --reload --host 0.0.0.0 --port 8000
28
+ ```
29
+
30
+ Acesse:
31
+ - API: http://localhost:8000
32
+ - Docs: http://localhost:8000/docs
33
+
34
+ ## 📡 Endpoints
35
+
36
+ ### `POST /api/analyze-exam`
37
+ Envia imagem para análise com IA
38
+
39
+ **Body:** FormData
40
+ - `file`: Arquivo de imagem (JPEG, PNG, etc)
41
+ - `patient_name`: Nome do paciente (opcional)
42
+
43
+ **Response:**
44
+ ```json
45
+ {
46
+ "success": true,
47
+ "timestamp": "2025-12-25T10:30:00",
48
+ "patient_name": "Maria Silva",
49
+ "file_info": {
50
+ "filename": "exame.jpg",
51
+ "content_type": "image/jpeg",
52
+ "size_bytes": 245678
53
+ },
54
+ "analysis": {
55
+ "model": "google/medgemma-4b-it",
56
+ "result": "Análise médica detalhada...",
57
+ "confidence": "high"
58
+ }
59
+ }
60
+ ```
61
+
62
+ ## 🔧 Tecnologias
63
+
64
+ - FastAPI
65
+ - Transformers (Hugging Face)
66
+ - Google MedGemma 4B
67
+ - Pillow (PIL)
68
+ - Uvicorn
69
+
70
+ ## ⚠️ Notas
71
+
72
+ - Requer token do Hugging Face
73
+ - Primeira execução baixa o modelo (~8GB)
74
+ - GPU recomendada para melhor performance
requirements.txt CHANGED
@@ -1,5 +1,7 @@
1
  fastapi
2
  uvicorn[standard]
3
- fastapi
4
- uvicorn[standard]
5
-
 
 
 
1
  fastapi
2
  uvicorn[standard]
3
+ transformers
4
+ huggingface_hub
5
+ pillow
6
+ python-multipart
7
+ torch