README.md

---
title: Debate Arena · Multi-Agent System
emoji: ⚔️
colorFrom: red
colorTo: blue
sdk: streamlit
sdk_version: "1.29.0"
python_version: "3.10"
app_file: app.py
pinned: false
---

# ⚔️ Debate Arena — Multi-Agent System

Sistema multi-agente onde **3 LLMs autônomos** debatem qualquer tema técnico, cada um com persona, objetivo e estilo distintos — sem LangChain ou CrewAI, orquestração manual que demonstra domínio dos fundamentos.

## 🤖 Os Agentes

| Agente | Papel | Personalidade |
|--------|-------|--------------|
| **ATLAS** | Arguer PRO | Assertivo, usa dados, antecipa objeções |
| **NEXUS** | Arguer CON | Cético, cirúrgico, expõe fragilidades |
| **ORACLE** | Judge | Imparcial, avalia 4 critérios, veredicto JSON |

## 🏗️ Arquitetura

```
Tema inserido pelo usuário
  ↓
ATLAS — abertura (system prompt PRO)
  ↓ [N rounds]
NEXUS — contra-argumento (system prompt CON)
ATLAS — resposta (contexto acumulado)
  ↓
NEXUS — argumento final
ATLAS — argumento final
  ↓
ORACLE — lê transcript completo → JSON estruturado
  ↓
Veredicto: vencedor + placar + 4 critérios + análise + insight
```

## 💡 Por que isso demonstra habilidade Senior?

- **3 system prompts distintos** com personas bem definidas
- **Contexto acumulado** passado corretamente a cada agente
- **Structured output** do ORACLE via JSON schema enforcement
- **Orquestração manual** sem frameworks — entende os fundamentos
- **Generator pattern** — cada turno faz yield para UI em tempo real
- **Zero dependências pesadas** — roda em CPU free tier do HF

## ⚙️ Secrets (HF Space Settings)

- `OPENAI_API_KEY`

## 🚀 Local

```bash
pip install -r requirements.txt
export OPENAI_API_KEY=sk-...
streamlit run app.py
```