README.md

---
title: Araras Gemma4 - Copiloto Clinico Doencas Raras
emoji: 🩺
colorFrom: green
colorTo: yellow
sdk: gradio
sdk_version: 5.0.0
app_file: app.py
pinned: true
license: apache-2.0
short_description: Gemma 4 PT-BR para apoio à decisão em doenças raras + SUS
---

# Araras-Gemma4 — Copiloto Clínico Offline

Live demo do [Raras-AI/araras-gemma4-e4b-v4-gguf](https://huggingface.co/Raras-AI/araras-gemma4-e4b-v4-gguf) — submissão ao [Gemma 4 Good Hackathon](https://kaggle.com/competitions/gemma-4-good-hackathon).

## Pra quem é

**Profissionais de saúde** (médicos, enfermeiros, agentes comunitários) atendendo nas UBSs brasileiras. Especialmente nas regiões onde a expertise especializada em doenças raras não chega.

## O que faz

- 🧠 Sugere diferenciais diagnósticos a partir do caso clínico
- 📜 Identifica PCDT do Ministério da Saúde aplicável
- 💊 Lista fármaco que o CEAF realmente dispensa
- 🏥 Orienta encaminhamento para centro de referência
- 💬 Conversa multi-turn — médico pergunta, copilot apoia

## Como funciona — pipeline completo offline

```
Profissional descreve caso (texto livre PT-BR)
    ↓
🧬 BioLORD-Brasil → extrai códigos HPO (PT-BR clínico → ontologia)
    ↓
🧠 Araras-Gemma4 E4B Q4_K_M (4.5B params) → ranqueia diferenciais
    ↓
✅ Hybrid canonical resolver (substring + BioLORD semantic @ 0.78) → resolve códigos ORPHA
    ↓
📋 PCDT overlay → fármaco CEAF + centro de referência
```

**Resultados no nosso RareBench-BR (833 casos, 0 erros):**
- R@1 = 41,2% | R@3 = 47,1% | **🔥 Track B PCDT-correct = 76,8%**
- Total stack: 5,5 GB. Latência p50 ~6s. **Zero cloud.**

## Compliance

Posicionado como **Software de Apoio à Decisão Clínica** (SaMD) sob ANVISA Res. 657/2022, 751/2022 e 830/2023. Alinhado com CFM: IA aumenta o profissional, **nunca substitui** o diagnóstico clínico.

## Links

- 🤗 [Modelo (147 MB adapter)](https://huggingface.co/Raras-AI/araras-gemma4-e4b-v4-sota)
- 🤗 [GGUF (5.3 GB)](https://huggingface.co/Raras-AI/araras-gemma4-e4b-v4-gguf)
- 🤗 [HPO matcher PT-BR](https://huggingface.co/Raras-AI/araras-hpo-brasil)
- 🐙 [Code](https://github.com/rarasAI/araras-gemma4)
- 🐙 [RareBench-BR (1k+ cases)](https://github.com/rarasAI/rarebench-br)
- 🌐 [raras.org](https://raras.org)

— Dimas, fundador da Raras, paciente raro (distonia mioclônica, 20 anos pro diagnóstico)