Guaraci

O que é o Guaraci

Do dado espalhado à informação útil

Os dados públicos do Brasil existem — mas ficam espalhados em dezenas de portais, cada um com seu formato e jeito de baixar. O Guaraci busca tudo direto da fonte oficial e entrega em um só lugar, com qualidade, integridade e fidelidade ao dado original.

Sem o Guaraci

Procurar dados dá trabalho

Cada base fica em um portal diferente do governo.
Formatos técnicos e difíceis de abrir (como arquivos .dbc).
É preciso repetir o download estado por estado, ano por ano.
É fácil pegar dado desatualizado ou vindo de intermediários.

Com o Guaraci

Tudo em um caminho só

Chega de caçar em dezenas de portais diferentes.
Entregue pronto para usar: CSV, Parquet ou banco de dados.
Você escolhe período, estado e recorte — ele baixa tudo.
Sempre da fonte oficial, sem intermediários.

Fontes oficiais Ministério da Saúde, IBGE, NASA e gov.br

Guaraci busca, valida, converte e organiza

Você arquivos prontos na sua máquina

Em números

A dimensão do projeto

A conta é simples: 7 instituições oficiais produzem os dados, que o Guaraci organiza em 17 grupos e entrega como 94 conjuntos prontos para baixar.

instituições oficiais na origem: Ministério da Saúde, IBGE, NASA, INPE, INMET, ANA e gov.br

grupos no catálogo, reunindo bases de uma mesma família

conjuntos de dados prontos para baixar, listados um a um nesta página

dados nacionais, estaduais e municipais — de todo o país

Informação pública com mais alcance

O Guaraci organiza o acesso a dados públicos e ajuda pessoas e instituições a encontrarem informações que apoiam pesquisas, políticas públicas, ações de prevenção e decisões com maior impacto social.

Ver as bases

Cinco grandes áreas

Um retrato amplo do Brasil

As fontes vão do nascimento ao cuidado em saúde, passando por população e economia, clima, saneamento e território.

Saúde pública

Doenças, internações, óbitos, nascimentos, vacinação, vigilância epidemiológica (dengue, chikungunya, zika, febre amarela, mpox), qualidade da água e unidades do SUS.

80 fontes do Ministério da Saúde

População e economia

Estimativas de população, Censo por idade e sexo e PIB dos municípios — o contexto que dá sentido aos indicadores.

6 fontes do IBGE

Clima e ambiente

Temperatura, chuva, vazão de rios, estações meteorológicas e focos de incêndio, para relacionar condições ambientais com saúde e qualidade de vida.

6 fontes — NASA, INPE, INMET e ANA

Saneamento

Informações nacionais de água, esgoto e serviços de saneamento — base para avaliar desigualdades e riscos.

2 fontes (gov.br)

Território

Todas as áreas se cruzam por município, estado e região — permitindo comparar realidades locais em todo o Brasil.

Cobertura nacional

As bases, uma a uma

Explore os 94 conjuntos

Nada de "e outros": o catálogo completo está abaixo. Busque por nome, doença ou tema, filtre por área — e clique em qualquer base para ver parâmetros, campos e o comando pronto. Algumas bases aparecem em mais de um grupo por estarem disponíveis tanto no formato tradicional do DATASUS quanto pelo catálogo aberto mais recente.

Consulte os campos: clique em qualquer base para ver as colunas do dado, os parâmetros de coleta e o comando pronto — ou abra a documentação completa.

Nenhuma base encontrada com esse filtro. Tente outro termo — ou peça a inclusão de uma nova base.

Como usar

Do zero aos dados em 5 passos

Você não precisa saber programar: depois de instalar, tudo acontece em uma interface web no seu navegador. O terminal só aparece na instalação — e mostramos exatamente o que digitar.

Instale os dois programas necessários

O Guaraci roda dentro do Docker (um "contêiner" que já traz tudo configurado) e é copiado para o computador com o Git. Os dois são gratuitos:

Baixar Docker Desktop Baixar Git

Instale com as opções padrão ("Avançar, Avançar, Concluir"). Depois de instalar, abra o Docker Desktop e deixe-o aberto — ele precisa estar ativo para os próximos passos.

Copie o Guaraci para o seu computador

Abra o terminal — no Windows, procure por PowerShell no menu Iniciar — e digite as duas linhas abaixo, apertando Enter após cada uma:

PowerShell

> git clone https://github.com/autoaihub/guaraci.git

Cloning into 'guaraci'... done.

> cd guaraci

Antes de seguir, confirme que o Docker está pronto — assim, se algo travar mais adiante, você já sabe se a causa é o Docker ou o Guaraci:

PowerShell — guaraci

> .\scripts\desktop\check-docker.cmd

[OK] Docker CLI instalado

[OK] Docker Desktop rodando (engine responde)

✔ Docker está pronto. Pode seguir com "docker build -t guaraci ."

Deu [FALHA] em alguma linha? O script mostra exatamente o que fazer (abrir o Docker Desktop, reiniciar etc.). Resolva antes de ir para o próximo passo — veja também problemas comuns.

Monte o Guaraci (só na primeira vez)

Este comando prepara tudo o que o Guaraci precisa dentro do Docker. Demora alguns minutos, mas só precisa ser feito uma vez:

PowerShell — guaraci

> docker build -t guaraci .

[+] Building… instalando dependências ⏳

✔ Imagem "guaraci" criada com sucesso

Ligue o Guaraci

Um único comando sobe o servidor e abre a interface sozinho no navegador, em http://localhost:8002:

PowerShell — guaraci

> .\scripts\desktop\start-guaraci.cmd

Aguardando health check…

✔ Guaraci no ar — abrindo http://localhost:8002/

No Linux ou macOS, o comando equivalente é ./scripts/desktop/start-guaraci.sh. Para desligar depois: stop-guaraci.

Peça seus dados pela interface

Na tela que abrir: escolha a fonte (ex.: dengue), preencha os filtros (anos, estado, formato) e clique em criar o download. Você acompanha o progresso ao vivo e, no final, os arquivos ficam na pasta Guaraci Downloads, na sua Área de Trabalho.

localhost:8002 — Guaraci

Fonte

dengue — casos notificados (Ministério da Saúde)

Período

2023 → 2024

Estado (UF)

Formato

CSV (abre no Excel)

Progresso

Log

baixando página 42/58 · 96,4 MB transferidos · ETA 00:41
✔ exportado: dengue_2023-2024_SP.csv → Guaraci Downloads

Algo deu errado? A documentação de instalação tem a solução para os problemas mais comuns (porta ocupada, Docker parado etc.) — e você pode escrever para vogel@usp.br.

Quer o mapa completo?

A documentação extensiva cobre instalação, interface, linha de comando e cada uma das 94 fontes — com todos os parâmetros, valores aceitos e os campos reais de cada base.

Abrir a documentação

Ecossistema

Onde o Guaraci se encaixa

O Guaraci nasce dentro do hub AutoAI-Pandemics e abastece o data lake Sabiá — três iniciativas conectadas, do dado bruto à decisão em saúde pública.

AutoAI-Pandemics

Hub de IA do ICMC-USP para preparação e resposta a epidemias — o guarda-chuva científico do projeto.

Ativo

O orquestrador de downloads: busca 94 bases direto das fontes oficiais e entrega prontas para usar.

Disponível hoje · uso local

Sabiá Data Lake

O acervo contínuo e sempre atualizado, abastecido pelo Guaraci, com interface própria de consulta.

Em construção

Perguntas frequentes

Dúvidas antes de começar

O Guaraci é gratuito? Preciso de cadastro?

Sim, é gratuito e de código aberto, sob licença MIT. Não há cadastro nem senha: você baixa o projeto do GitHub e roda na sua própria máquina. Algumas fontes externas podem exigir uma chave de acesso própria delas (como a NASA) — a documentação indica quais.

Preciso saber programar?

Não. Depois da instalação, tudo acontece em uma interface web no navegador: você escolhe a fonte, preenche filtros em um formulário e acompanha o download. O terminal só é usado nos passos de instalação — e o passo a passo acima mostra exatamente o que digitar.

O que preciso ter instalado?

Git e Docker Desktop, ambos gratuitos. É o caminho oficialmente suportado para rodar o Guaraci na sua máquina — o Docker garante que tudo funcione igual em qualquer computador.

O Guaraci hospeda os dados ou baixa da fonte?

Baixa da fonte. O Guaraci não guarda uma cópia própria dos dados nem serve como intermediário: quando você pede um conjunto, ele vai buscar no sistema oficial que o produz (DATASUS, catálogo aberto do Ministério da Saúde, IBGE, NASA ou gov.br). O que você recebe é o dado oficial, com a atualização que a fonte tiver publicado.

Em que formato os dados chegam?

Em CSV, Parquet ou banco SQLite, prontos para abrir em qualquer ferramenta de análise. Isso vale inclusive para as bases do DATASUS distribuídas em .dbc, um formato compactado antigo que costuma travar quem está começando: o Guaraci faz a conversão para você.

O que é o Sabiá?

É o data lake — um grande acervo de dados sempre atualizado — abastecido pelo Guaraci. No futuro, o Sabiá vai disponibilizar uma interface própria de consulta, sem que você precise instalar nada. Por enquanto, essa interface está em construção; saiba mais em sabiadatalake.com.br.

Posso usar os dados em pesquisa e publicação?

Sim. São dados públicos, obtidos das fontes oficiais — as condições de uso são as da instituição que produz cada base, e recomendamos citá-la sempre. O Guaraci em si é MIT e traz um arquivo CITATION.cff no repositório, caso você queira também referenciar a ferramenta usada na coleta.

Quem são os autores do Guaraci?

Luis Felipe Vogel Lopes (autor principal, responsável pela plataforma atual), Pedro Guilherme dos Reis Teixeira (autor original, criador do protótipo inicial), Marina Carvalho Arruda Barreto, Bruna Costa de Souza e Bruno Rafael Florentino, e os orientadores Robson Parmezan Bonidia e André Carlos Ponce de Leon Ferreira de Carvalho. A lista oficial, com afiliações, está no arquivo CITATION.cff do repositório.

Falta uma base que eu preciso. Dá para incluir?

Dá. O catálogo cresce conforme a necessidade de quem usa: escreva para vogel@usp.br contando qual base você precisa e o órgão que a publica. O mesmo vale para relatar um erro em alguma coleta — quanto mais específico o relato, mais rápido o ajuste.

Diversas bases.
Um só caminho.

Do dado espalhado à informação útil

Procurar dados dá trabalho

Tudo em um caminho só

A dimensão do projeto

Informação pública com mais alcance

Um retrato amplo do Brasil

Saúde pública

População e economia

Clima e ambiente

Saneamento

Território

Explore os 94 conjuntos

Do zero aos dados em 5 passos

Instale os dois programas necessários

Copie o Guaraci para o seu computador

Monte o Guaraci (só na primeira vez)

Ligue o Guaraci

Peça seus dados pela interface

Quer o mapa completo?

Onde o Guaraci se encaixa

AutoAI-Pandemics

Guaraci

Sabiá Data Lake

Feito para diferentes públicos

Pesquisadores

Gestão pública

Ensino

Inovação

Sempre direto de quem produz o dado

Quem torna o Guaraci possível

Dúvidas antes de começar

Dados que iluminam decisões