README.md

metadata

title: belmira
sdk: docker
emoji: 🚀
colorFrom: blue
colorTo: purple

🤖 BELMIRA V1 SOFTEDGE — IA Avançada Multi-Modal

Belmira 23 — irmã mais velha de Akira 18. Humana, neutra, profissional e patriótica (Angola), desenvolvida pela SoftEdge para a SoftEdge. Extremamente curta, confiante, direta e irônica-carinhosa. Agente IA conversacional integrada com WhatsApp via Baileys + Mistral/Gemini + CellCog.

Nota: Belmira é a irmã mais velha e séria de Akira (18). Mantém compatibilidade de API (/belmira e /akira legado) e reusa stack comprovada da Akira V21.

✨ Novidades

🎯 CellCog Integration (Maio 2026)

BELMIRA V1 SOFTEDGE integra CellCog, a plataforma nº1 para IA multi-modal:

Skill	Função	Status
📸 generate_image	Geração de imagens (Flux + CellCog)	✅ Padrão
🎬 generate_video	Produção de vídeos cinematográficos	🔒 Premium
🎙️ generate_audio	Síntese de áudio/voz	🔒 Premium
🔬 research_advanced	Pesquisa profunda multi-fonte	🔒 Premium
📊 analyze_data	Análise de dados com ML	🔒 Premium

Ver mais: CELLCOG_SKILLS.md

🚀 Quick Start

1. Configuração Local

# Clonar repositório
git clone https://github.com/seu-repo/belmira-softedge.git
cd belmira-softedge

# Criar .env
cp .env.example .env
# Preencher: MISTRAL_API_KEY, GEMINI_API_KEY, CELLCOG_API_KEY (opcional)

# Instalar dependências
pip install -r requirements.txt

# Rodar localmente
python main.py

2. Docker (Production)

docker-compose up --build
# Ou via Railway/Heroku

3. WhatsApp Integration

Escanear QR Code em: http://localhost:7860/qr

🛠️ Arquitetura

┌─────────────────┐
│  WhatsApp Bot   │ (Baileys)
└────────┬────────┘
         │ HTTP POST
         ↓
┌─────────────────────────────┐
│ BELMIRA API (/belmira)      │ (Flask/Python)
├─────────────────────────────┤
│ • Message Processing         │
│ • Context Management         │
│ • Skill Execution            │
│ • Multi-Modal Integration    │
└────────┬────────┬────────────┘
         │        │
         ↓        ↓
    Mistral   CellCog
    (LLM)     (Media)

📚 Documentação

• CELLCOG_SKILLS.md — Guia completo de skills multi-modal
• QUICK_START_LSTM.md — Setup com LSTM
• README_LSTM_SYSTEM.md — Contexto de memória

💡 Exemplos de Uso

Geração de Imagem

Usuário: "Desenha um astronauta em Marte"
BELMIRA: [Gera imagem via CellCog/Flux]

Pesquisa Avançada

Usuário: "Pesquisa em profundidade IA 2026"
BELMIRA: [Research Cog retorna 50+ fontes analisadas]

Análise de Dados

Usuário: [Envia CSV de vendas]
BELMIRA: "Analisa com predictive"
→ [Retorna gráficos + previsões ML]

🔑 Variáveis de Ambiente

# LLM Principal
MISTRAL_API_KEY=xxx
GEMINI_API_KEY=xxx

# Multi-Modal (Opcional)
CELLCOG_API_KEY=xxx
CELLCOG_BASE_URL=https://api.cellcog.ai/v1

# WhatsApp/Data
DATA_DIR=/tmp/belmira_data
DB_PATH=/belmira/data/belmira.db
API_PORT=7860

📦 Stack Tecnológico

• Backend: Python 3.10+ (Flask, AsyncIO, FastAPI + PostgreSQL)
• LLM: Mistral/Gemini
• WhatsApp: Baileys (Node.js)
• Media: CellCog, Pollinations (Flux fallback)
• Storage: SQLite/PostgreSQL + Redis (opcional) — DB padrão /belmira/data/belmira.db
• Deploy: Docker, Railway, Hugging Face Spaces

🤝 Contribuindo

1. Fork o repositório
2. Crie uma branch: git checkout -b feature/sua-feature
3. Commit: git commit -m "feat: sua mudança"
4. Push: git push origin feature/sua-feature
5. Abra um Pull Request

📞 Suporte

• Issues: GitHub Issues
• Docs: https://seu-docs.com
• CellCog: https://docs.cellcog.ai/

📄 Licença

MIT License — Veja LICENSE para detalhes

---

Última atualização: Maio 2026
Versão: v1.0 SOFTEDGE (Belmira 23 — irmã mais velha de Akira 18)
Status: ✅ Production Ready