README.md

---
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](CELLCOG_SKILLS.md)

## 🚀 Quick Start

### 1. Configuração Local
```bash
# 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)
```bash
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](CELLCOG_SKILLS.md) — Guia completo de skills multi-modal
- [QUICK_START_LSTM.md](QUICK_START_LSTM.md) — Setup com LSTM
- [README_LSTM_SYSTEM.md](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

```env
# 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](LICENSE) para detalhes

---

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