🎯 MaestroIA

Orquestração Inteligente de Agentes de Marketing Digital

Automatize campanhas, gere relatórios em PDF e receba pagamentos via Mercado Pago em uma interface elegante estilo ebook.

📖 Sobre o Projeto

O MaestroIA é uma plataforma visual e interativa para orquestração de agentes de IA em marketing digital. Com interface estilo ebook, você cria campanhas, gera conteúdos, acompanha resultados e baixa relatórios em PDF — tudo em poucos cliques, sem precisar de conhecimento técnico.

Destaques:

• Interface Streamlit elegante, responsiva e moderna
• Relatórios em PDF com visual profissional
• Integração Mercado Pago para planos pagos
• Experiência de uso inspirada em eBooks e dashboards premium
• Novidade v1.1.0: Integrações reais com APIs (OpenAI, Google Trends, Mercado Pago, Meta OAuth) com fallbacks para desenvolvimento offline

✨ Funcionalidades Principais

🤖 Agentes Inteligentes

• Pesquisador: Analisa tendências e oportunidades (integra Google Trends)
• Estrategista: Cria estratégias de marketing (usa OpenAI GPT-4o-mini)
• Criador de Conteúdo: Gera posts e anúncios otimizados (com IA generativa)
• Publicador: Simula publicações em múltiplas redes (estrutura para Meta, Google Ads)
• Otimizador: Sugere melhorias com base em dados
• Maestro: Orquestra e supervisiona todo o fluxo

💎 Experiência Visual

• Design com gradientes, cards e feedback animado
• Relatórios em PDF estilo ebook, prontos para download
• Interface responsiva, intuitiva e acessível

🔗 Integrações

• OpenAI (GPT-4o-mini, DALL-E) - Respostas reais ou fallbacks simulados
• Google Trends - Dados reais de tendências ou simulados
• Mercado Pago (pagamentos de planos) - Integração real
• Meta OAuth (Facebook/Instagram) - Estrutura para autenticação
• Google Ads - Simulação com estrutura para integração

🔐 Segurança

• Cadastro seguro, validação de email e senha forte
• Fallbacks automáticos para APIs indisponíveis (modo offline seguro)
• Dados criptografados e controle de acesso

🚀 Instalação e Primeiros Passos

Pré-requisitos

• Python 3.14+
• Git
• Conta OpenAI (para IA)

Instalação Rápida

# Clone o repositório
git clone https://github.com/TiagoIA-UX/MaestroIA.git
cd MaestroIA

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

# Instale as dependências
pip install -r requirements.txt

Configuração

1. Copie .env.example para .env e preencha suas chaves:

   • OPENAI_API_KEY=sk-...
   • MERCADOPAGO_ACCESS_TOKEN=...
   • Outras chaves conforme integrações desejadas

2. Execute a interface web:

streamlit run ui_app.py

3. Acesse: http://localhost:8501

Primeiro Uso

1. Cadastre-se na aba 📝 Cadastrar-se
2. Crie sua campanha em 📝 Criar Campanha
3. Veja resultados e baixe o PDF em 📊 Resultados
4. Faça upgrade de plano em 💎 Planos & Pagamento

🗂️ Estrutura do Projeto

maestroia/
├─ agents/          # Agentes inteligentes
├─ config/          # Configurações
├─ core/            # Governança e estado
├─ graphs/          # Orquestração (LangGraph)
├─ memory/          # Memória vetorial
├─ services/        # Lógica de campanhas
├─ tools/           # Ferramentas auxiliares
├─ ui/              # Componentes Streamlit
├─ ui_app.py        # App principal (Streamlit)
├─ users.json       # Usuários
├─ requirements.txt
├─ .env.example
└─ README.md

🛠️ Tecnologias

• Python 3.14+
• Streamlit (UI elegante)
• OpenAI API (GPT-4o-mini, DALL-E)
• Mercado Pago (pagamentos)
• LangGraph (orquestração de agentes)
• FAISS (memória vetorial)
• ReportLab (PDF estilo ebook)
• APIs de Redes Sociais (simulação e estrutura)

🔑 Configuração de APIs (Opcional)

Para integrações reais, preencha as chaves no .env:

OPENAI_API_KEY=sk-...
MERCADOPAGO_ACCESS_TOKEN=...
# Outras chaves: Twitter, Meta, etc.

Sem chaves, o sistema funciona em modo simulado.

Segurança das chaves

Não comite o arquivo .env com chaves reais. O repositório já ignora .env via .gitignore — recomenda-se usar variáveis de ambiente no CI ou serviços secretos do provedor de hospedagem. Para testes locais, copie .env.example para .env e preencha OPENAI_API_KEY.

Integrações reais

Implementações iniciais adicionadas:

• OpenAI: wrapper em maestroia/services/openai_service.py (chat + imagens). Requer OPENAI_API_KEY no .env.
• Google Trends: encapsulado em maestroia/services/trends_service.py (usa pytrends, com fallback se indisponível).
• Mercado Pago: wrapper em maestroia/services/mercadopago_service.py (criar preferência / verificar pagamento). Requer MERCADOPAGO_ACCESS_TOKEN se quiser usar de fato.

Instale dependências:

pip install -r requirements.txt

Para inserir a chave localmente com segurança use:

python scripts/insert_env_key.py

Testes

Execute os testes unitários:

python -m unittest discover maestroia/tests

Ou use os scripts admin:

# PowerShell
.\scripts\admin_run_tasks.ps1

# Python
python scripts/admin_run_tasks.py

🎬 Exemplo Visual e Saídas

Ao criar uma campanha, você recebe:

• Análise de mercado (texto detalhado)
• Estratégia (plano de ação)
• Conteúdos (posts e anúncios)
• Publicações (simulação)
• Otimização (sugestões de melhoria)
• Imagens geradas (DALL-E)
• Relatório PDF (ebook visual)

Exemplo de PDF gerado

💳 Planos e Pagamento

Escolha seu plano e pague com Mercado Pago direto na interface:

• Gratuito: 2 campanhas/mês, 2 canais, 7 dias de teste
• Starter: 10 campanhas/mês, 5 canais, 14 dias de teste, R$ 49,90/mês
• Professional: 50 campanhas/mês, 10 canais, 30 dias de teste, R$ 149,90/mês
• Enterprise: Ilimitado, 30 dias de teste, R$ 499,90/mês

O upgrade é feito via link Mercado Pago. Após o pagamento, o plano é ativado.

🚦 Status e Roadmap

• ✅ MVP Visual e funcional (Streamlit)
• 🔄 Próximos: Integrações reais, analytics, agendamento real
• 🚀 Futuro: Plugins, painel admin, IA avançada

🤝 Contribuição

1. Fork este repositório
2. Crie uma branch: git checkout -b feature/nova-funcionalidade
3. Commit: git commit -m 'feat: nova funcionalidade'
4. Push: git push origin feature/nova-funcionalidade
5. Abra um Pull Request

📄 Licença

MIT License

👤 Autor

Tiago Rocha

Desenvolvido com foco em inovação, experiência visual e escalabilidade para o futuro do marketing digital.

---

📚 Casos de Uso

• Orquestração de agentes de marketing digital
• Automação de processos com IA
• Plataformas educacionais e de conteúdo
• Base para SaaS com múltiplos agentes

---

📜 Atribuições

Para citações e licenças de terceiros, veja ATTRIBUTIONS.md.

---