Web App Nomes IBGE

Aplicação web que consulta a frequência de nomes ao longo das décadas utilizando a API do IBGE.

Estrutura do Projeto

projeto/
├── src/
│   ├── __init__.py
│   ├── exceptions.py
│   ├── api/
│   │   ├── __init__.py
│   │   └── ibge.py
│   └── ui/
│       ├── __init__.py
│       └── app.py
├── main.py
├── requirements.txt
└── README.md

Instalação

1. Clone o repositório
2. Crie um ambiente virtual:

   python -m venv venv
   source venv/bin/activate  # Linux/Mac
   # ou
   .\venv\Scripts\activate  # Windows

3. Instale as dependências:

   pip install -r requirements.txt

Execução

Para executar a aplicação:

streamlit run main.py

Funcionalidades

• Consulta de frequência de nomes por década
• Visualização em tabela e gráfico
• Tratamento de erros e logging
• Interface amigável com Streamlit

API

A aplicação utiliza a API pública do IBGE: https://servicodados.ibge.gov.br/api/docs/nomes?versao=2