MULT-CHAT-HUB

Hub de colaboração multi-IA com motor analítico embutido.
Frontend React 19 + Vite · Backend Express · Desktop via Electron · LLM local via Ollama.

Visão geral

Plataforma onde múltiplas IAs colaboram como uma equipe num único ambiente self-contained, sem chave de API e sem nuvem obrigatória. Inclui:

• Chat com IAs locais (Ollama / fazendaavila2026/avila) e gateways externos (NullClaw).
• Quantum Analytical Engine em TypeScript puro — 5 análises quantitativas executadas localmente:
  • analyze_descriptive — estatísticas (count, mean, std, min, p25/p50/p75, max).
  • analyze_predictive — regressão linear multivariada (ml-regression-multivariate-linear).
  • detect_anomalies — z-score multivariado com limiar 2.5.
  • optimize_linear — programação linear (javascript-lp-solver).
  • recommend_stack — recomendação de stack tecnológica.
• Upload de CSV/JSON, persistência em localStorage, gráficos inline via recharts.
• Comandos slash que a IA emite e o app executa: /criar_tarefa, /use_tool, /gerar_relatorio etc.

Pré-requisitos

• Node.js 20+
• Ollama instalado
• ollama serve rodando em background
• Modelo baixado: ollama pull fazendaavila2026/avila (≈ 2GB, context window 128K)

Rodar localmente

npm install
cp .env.example .env.local        # ajuste OLLAMA_HOST/MODEL se necessário
npm run dev:all                   # frontend :3001 + backend :3000

Abra http://localhost:3001.

Empacotar como .exe Windows (Electron + NSIS)

Em uma máquina Windows:

npm install
npm run electron:build

Instalador gerado em release/MULT CHAT HUB Setup <versão>.exe. Ícone, asarUnpack e logging em %APPDATA%/MULT CHAT HUB/logs/ já configurados.

O app instalado precisa do Ollama rodando em localhost:11434 com o modelo fazendaavila2026/avila baixado.

Alternativamente, dispare o workflow release.yml via push de tag v* ou workflow_dispatch para builds automatizados em windows-latest.

Deploy no Vercel (modo demo: análises + UI completa)

O frontend é um SPA Vite/React publicável no Vercel:

Config em vercel.json — buildCommand: npm run build:frontend, outputDirectory: dist. Vercel detecta automaticamente.

O que funciona no Vercel (sem backend, 100% client-side):

Recurso	Status no Vercel
UI completa, navegação, persistência localStorage	✅
Upload de CSV/JSON + preview	✅
analyze_descriptive, analyze_predictive, detect_anomalies, optimize_linear, recommend_stack	✅ (engine TypeScript puro roda no browser)
Gráficos recharts inline	✅
Comandos slash (/criar_tarefa, /concluir_tarefa, /limpar_dados, /gerar_relatorio)	✅
Chat com Ollama (/api/chat)	❌ Requer Ollama local — modo desktop
Tools github_*, calculate_math, store/retrieve_memory, get_current_time	❌ Backend Express
Gateway NullClaw externo	❌

Quando uma tool exige backend, o app exibe mensagem clara orientando a rodar npm run dev:all localmente.

Para chat completo no Vercel: hospede o backend Express separadamente (Fly.io, Railway, VPS com Ollama) e edite o proxy /api em vite.config.ts.

Variáveis de ambiente

Variável	Default	Descrição
OLLAMA_HOST	http://localhost:11434	URL do servidor Ollama
OLLAMA_MODEL	fazendaavila2026/avila:latest	Modelo padrão do /api/chat
VITE_GITHUB_TOKEN	(vazio)	Opcional, usado pelas tools github_list_repos / github_create_issue
PORT	3000	Porta do backend Express

Arquitetura

electron/main.cjs        ── janela Electron + spawn do Express
server/                  ── backend Express
  controllers/           ── chat (Ollama proxy), tools (engine + GitHub)
  lib/analyticalEngine   ── 5 análises em TypeScript puro
  routes/api.ts          ── /api/chat, /api/tools/execute
src/
  components/            ── UI React (ChatArea, Sidebar, AnalysisChart, ManualModal)
  context/ChatContext    ── state global, parser de comandos, persistência
  types.ts               ── Message, AnalysisResult, etc.
public/                  ── favicons, logo (servido por Vite)
build/                   ── recursos do electron-builder (icon.ico)

Licença

Apache-2.0.