Voltar aos Projetos

    🏩 Agente Mercado Pix

    Sistema de InteligĂȘncia de Mercado que integra dados reais do sistema Pix com anĂĄlise financeira utilizando CrewAI e dados oficiais do Banco Central do Brasil.

    InteligĂȘncia Artificial
    4 min de leitura
    43 visualizaçÔes
    🏩 Agente Mercado Pix

    đŸ› ïž Tecnologias Utilizadas

    CrewAi
    PIX
    Streamlit

    đŸ—ïž Arquitetura

    ┌──────────────────────┐
│   Frontend (UI)      │
│   (Streamlit)        │
└─────────┬────────────┘
          │
          ▌
┌────────────────────────┐
│   Orquestrador         │
│   (CrewAI)             │
└─────┬──────┬───────────┘
      │      │
      ▌      ▌
┌───────────────┐  ┌──────────────┐
│ 4 Agentes AI  │  │ API Pix BCB  │
│ Especializados│  │ (Dados Pix)  │
└───────────────┘  └──────────────┘

    đŸ€– Agentes CrewAI

    1. 🎯 Especialista em Dados Pix - Coleta estatísticas oficiais do Banco Central
    2. 📰 Pesquisador de Mercado - Busca informaçÔes sobre fintechs e tendĂȘncias
    3. 📊 Analista Financeiro - Cruza dados e gera insights estratĂ©gicos
    4. 📋 Redator Executivo - Consolida relatórios profissionais

    🚀 Instalação e Uso

    MĂ©todo Recomendado (Script AutomĂĄtico)

    # Clone o projeto
git clone <repository>
cd agent-mercado-pix

# Execute o script automĂĄtico
./start_venv.sh

    MĂ©todo Manual

    # Criar ambiente virtual
python3 -m venv venv
source venv/bin/activate

# Instalar dependĂȘncias
pip install -r requirements.txt

# Configurar API Key
cp .env.example .env
# Editar .env com sua OPENAI_API_KEY

# Executar aplicação
python app.py              # Interface web (padrĂŁo)
python app.py --demo       # Demo rĂĄpido
python app.py --analysis   # AnĂĄlise completa

    đŸ“± Interface Streamlit

    A interface web oferece:

    • ⚙ ConfiguraçÔes - ParĂąmetros de anĂĄlise e municĂ­pio
    • 📊 Dashboard - VisualizaçÔes dos dados Pix
    • 📈 GrĂĄficos - Evolução temporal e mĂ©tricas
    • 📋 RelatĂłrios - Download de anĂĄlises completas

    Funcionalidades

    • ✅ Seleção de municĂ­pio e perĂ­odo
    • ✅ TrĂȘs modos de execução (Demo, Completa, Teste)
    • ✅ VisualizaçÔes interativas com Plotly
    • ✅ Status em tempo real dos agentes
    • ✅ Download de relatĂłrios
    • ✅ Interface responsiva e intuitiva

    🎯 Modos de Uso

    Interface Web (Recomendado)

    python app.py --web
# ou simplesmente
python app.py

    Demo RĂĄpido

    python app.py --demo

    AnĂĄlise Completa

    python app.py --analysis --municipio "SAO PAULO" --periodo "2024-01"

    📊 API Dados Pix

    O sistema utiliza a API oficial do Banco Central:

    • Endpoint: https://olinda.bcb.gov.br/olinda/servico/Pix_DadosAbertos/versao/v1/odata
    • Dados: TransaçÔes Pix por municĂ­pio e perĂ­odo
    • Formato: OData/JSON

    Exemplo de consulta:

    TransacoesPixPorMunicipio?$filter=MesAno eq '2024-01' and Municipio eq 'SĂŁo Paulo'&$format=json

    đŸ—‚ïž Estrutura do Projeto

    agent-mercado-pix/
├── app.py               # 🚀 Ponto de entrada principal
├── streamlit_app.py     # 🌐 Interface web Streamlit
├── main.py              # 📊 CLI análise completa
├── run_demo.py          # ⚡ Demo rápido
├── start_app.py         # 🔧 Script alternativo
├── start_venv.sh        # 🐍 Script ambiente virtual
├── requirements.txt     # 📩 DependĂȘncias Python
├── .env.example         # ⚙  Configuração exemplo
├── .gitignore          # 🙈 Arquivos ignorados
├── venv/               # 🏠 Ambiente virtual Python
├── src/
│   ├── agents/         # đŸ€– 4 agentes CrewAI especializados
│   ├── tasks/          # 📋 DefiniçÔes de tarefas
│   ├── tools/          # 🔌 Integração API Pix BCB
│   └── crew_orchestrator.py  # 🎭 Coordenador principal
└── plano.md           # 📚 Documentação da arquitetura

    🔑 Configuração

    VariĂĄveis de ambiente (.env):

    OPENAI_API_KEY=sua_chave_openai_aqui
DATABASE_URL=postgresql://username:password@localhost/db
BCB_API_BASE_URL=https://olinda.bcb.gov.br/olinda/servico/Pix_DadosAbertos/versao/v1/odata

    📈 Funcionalidades Principais

    🌐 Interface Web Streamlit

    • Dashboard interativo e responsivo
    • Configuração visual de parĂąmetros
    • GrĂĄficos em tempo real
    • Download de relatĂłrios

    đŸ€– AnĂĄlise com IA (CrewAI)

    • 4 agentes especializados trabalhando em equipe
    • Integração com dados reais do Banco Central
    • AnĂĄlise financeira automatizada
    • RelatĂłrios executivos profissionais

    📊 Dados Oficiais Pix

    • API oficial do Banco Central do Brasil
    • Dados reais de transaçÔes por municĂ­pio
    • EstatĂ­sticas financeiras detalhadas
    • InformaçÔes atualizadas mensalmente

    🎹 Interface Visual

    A interface Streamlit inclui:

    • 📊 GrĂĄficos interativos (Plotly)
    • 📋 Tabs organizadas por tipo de dados
    • đŸŽ›ïž Sidebar com configuraçÔes
    • đŸ“„ Download de relatĂłrios
    • 🔄 Status em tempo real

    đŸ€ Como Contribuir

    1. Fork o projeto
    2. Crie uma branch para sua feature
    3. Commit suas mudanças
    4. Push para a branch
    5. Abra um Pull Request