🚀 NEX Framework 2.0

Multi-LLM AI Framework with Cursor Rules Integration
Framework completo de Agentes AI para desenvolvimento de software inteligente

🎉 What's New in NEX 2.0

✨ Major Features

• 🤖 Multi-LLM Support: Claude Sonnet, GPT-4, Haiku, GPT-4o-mini, and more
• ⚡ Cursor Integration: One-command install to .cursor/rules/nex/
• 🚀 Ultra-Fast: Installation in < 1 second (214 files)
• ✅ Auto-Validation: Built-in verification and health checks
• 💾 Smart Backup: Automatic backup system before updates
• 📦 Complete: All agents, workflows, tasks, and tools included

# Execute o setup wizard interativo
npx nex-app@latest

# O wizard irá:
# ✓ Perguntar sobre instalação de Cursor Rules
# ✓ Perguntar sobre abrir NEX Hub no browser
# ✓ Instalar e configurar tudo automaticamente

# Depois, use no Cursor:
# @nex/core/agents/nex-master

📖 Full Changelog | 📋 Technical Spec | 🧪 Test Report

NEX é um framework avançado de agentes AI que permite criar, gerenciar e orquestrar múltiplos agentes especializados para desenvolvimento de software, planejamento de projetos, análise de requisitos e muito mais.

📋 Índice

• Características
• Instalação
• Início Rápido
• Arquitetura
• Documentação
• Estrutura do Projeto
• Agentes
• CLI
• NEX Store
• Contribuindo
• Licença

✨ Características

🎯 Agentes de Planejamento

• ANX - Análise de requisitos e geração de insights
• PMX - Gestão de produto e criação de PRDs
• ARX - Arquitetura de sistemas e infraestrutura
• DVX - Desenvolvimento e geração de código
• DOCX - Documentação técnica
• QAX - Garantia de qualidade e testes
• DEPX - Deploy e CI/CD
• MONX - Monitoramento e observabilidade

🤖 Agentes de Execução

• 18 agentes especializados para execução de comandos
• Sistema de orquestração multi-agente
• Validação multi-camada
• Busca semântica com vetorização

🛠️ Ferramentas

• CLI completo para gerenciamento de projetos
• Sistema de workflows pré-definidos e customizáveis
• Templates para PRDs, user stories e arquitetura
• Sistema de preferências técnicas configuráveis
• Sharding inteligente para otimização de tokens
• Web UI para gerenciamento visual

🏪 NEX Agent Marketplace

• Registry completo de agents (planning + execution + community)
• CLI poderoso para instalação e gerenciamento
• Sistema de versionamento semântico
• Dependency management automático
• Supabase integration para sync e analytics
• Reviews & ratings (database ready)
• Search & discovery inteligente
• Official & community agents

🧠 Inteligência Artificial

• Suporte a múltiplos providers (OpenAI, Claude, Gemini, Mistral)
• Configuração flexível de modelos
• Integração de IA em todos os agentes
• Sistema de aprendizado contínuo

📦 Instalação

Instalação Rápida via NPX (Recomendado)

# Execute o setup wizard interativo
npx nex-app@latest

# O wizard perguntará:
# 1. Install NEX agents in Cursor (.cursor/rules/nex/)? [Y/n]
# 2. Open NEX Hub in browser after installation? [Y/n]

# Depois, no Cursor, use:
@nex/core/agents/nex-master

# Ou instale agentes adicionais do marketplace:
nex agent install anx

Pré-requisitos

• Node.js >= 18.0.0
• npm ou yarn
• Git
• Conta no Supabase (para backend e banco de dados)
• Conta no Vercel (para deploy do frontend)

Instalação Local (Para Desenvolvimento)

# Clone o repositório
git clone https://github.com/INOSX/nex-store.git
cd nex-store

# Instale as dependências
npm install

# Configure as variáveis de ambiente
cp .env.example .env
# Edite o .env com suas configurações do Supabase:
# VITE_SUPABASE_URL=your_supabase_project_url
# VITE_SUPABASE_ANON_KEY=your_supabase_anon_key

Configuração do Supabase

1. Crie um projeto no Supabase
2. Execute as migrations:

   # Instale o Supabase CLI
   npm install -g supabase
   
   # Faça login
   supabase login
   
   # Link seu projeto
   supabase link --project-ref your-project-ref
   
   # Execute as migrations
   supabase db push

3. Configure as Edge Functions:

   supabase functions deploy nex-store-auth
   supabase functions deploy nex-store-agents
   supabase functions deploy nex-manager-api

Instalação via NPM

O NEX Framework é instalado automaticamente via NPX. Para usuários que precisam instalar globalmente:

# Instalar NEX CLI globalmente (opcional)
npm install -g nex-app@latest

🚀 Início Rápido

Novo Usuário - Instale o NEX

# 1. Instale o NEX Framework (GRATUITO)
npx nex-app@latest

# 2. Acesse o NEX Hub no browser
# O instalador abrirá automaticamente: http://localhost:3000/hub

# 3. Browse e instale agentes
nex agent search "planning"
nex agent install anx

# 4. Use os agentes no Cursor
# No chat do Cursor, digite: @anx analise este projeto

Desenvolvimento Local

# Iniciar servidor de desenvolvimento (Vite)
npm run dev

# O frontend estará disponível em http://localhost:3000

Deploy no Vercel

1. Conecte seu repositório ao Vercel
2. Configure as variáveis de ambiente no Vercel:
   • VITE_SUPABASE_URL
   • VITE_SUPABASE_ANON_KEY
3. O Vercel detectará automaticamente o Vite e fará o deploy

Usando o CLI

# Instalar o NEX (se ainda não instalou)
npx nex-app@latest

# Gerenciar agentes
nex agent search "analysis"    # Buscar agentes
nex agent install anx          # Instalar ANX - Analysis Expert
nex agent list                 # Listar instalados
nex agent info anx             # Ver detalhes
nex agent update anx           # Atualizar
nex agent uninstall anx        # Remover

# Executar workflows (com agentes instalados)
nex workflow full-stack-app

# Configurar IA
nex config ai --provider openai

Uso Programático

import { NEXOrchestrator } from '@nex/framework'

const orchestrator = new NEXOrchestrator()

// Processar comando
const result = await orchestrator.processCommand(
  "Liste todas as empresas",
  user,
  context
)

// Executar workflow de planejamento
const plan = await orchestrator.executePlanningWorkflow(
  requirements,
  context
)

🏗️ Arquitetura

Stack Tecnológica

• Frontend: Vite + React (deploy no Vercel)
• Backend: Supabase Edge Functions (Deno)
• Banco de Dados: Supabase PostgreSQL
• Autenticação: Supabase Auth
• Storage: Supabase Storage

Padrão de Agentes

NEX segue o padrão de categorização de agentes:

• 🔷 NEX (Nexus) - Orquestração central
• 📐 ORDX (Ordo) - Ordem, validação e estruturação
• 🌊 FLX (Fluxus) - Fluxo contínuo e planejamento
• ⚡ AGX (Agens) - Execução de ações de domínio
• 🔧 OPX (Opus) - Execução técnica especializada

Para mais detalhes, consulte: PADRAO_NEX_FLX_AGX_OPX_ORDX.md

📚 Documentação

Documentação Principal

• Padrão NEX/FLX/AGX/OPX/ORDX - Explicação completa do padrão de nomenclatura e arquitetura
• Documentação de Agentes - Documentação detalhada de todos os 18 agentes
• Diagramas de Agentes - Diagramas Mermaid de cada agente
• Fluxo do Sistema - Fluxo completo de processamento
• Resumo de Implementação - Visão geral das implementações

Documentação Técnica

• Configuração Vite + Supabase - Guia completo de configuração do frontend e backend
• Guia de Deploy - Como fazer deploy no Vercel e Supabase
• Módulo Especialista IA - Documentação do módulo de especialista
• Integração de IA - Estratégia de integração de IA nos agentes
• Guia de Testes - Guia completo de testes
• Testes Rápidos - Testes rápidos e exemplos

📁 Estrutura do Projeto

nex-agents/
├── cli/                          # CLI do framework
│   └── nex-cli.js
├── src/
│   ├── services/
│   │   ├── nex-execution/        # Agentes de execução
│   │   │   ├── nexOrchestrator.js
│   │   │   ├── agents/           # 18 agentes especializados
│   │   │   ├── services/         # Serviços de vetorização
│   │   │   └── utils/            # Utilitários
│   │   ├── nex/                  # Sistema NEX Framework
│   │   │   ├── agents/planning/  # Agentes de planejamento
│   │   │   ├── core/             # Core do framework
│   │   │   ├── api/              # APIs
│   │   │   └── installer/        # Sistema de instalação
│   │   ├── nex-store/            # NEX Store (marketplace)
│   │   └── nex-installer/        # Instalador de agentes
│   ├── components/               # Componentes React
│   │   ├── specialist/          # Módulo especialista
│   │   ├── nex-manager/         # Gerenciador web
│   │   └── store/               # Loja virtual
│   ├── pages/                   # Páginas React
│   │   ├── admin/               # Painel admin
│   │   └── store/                # Páginas da loja
│   └── config/                   # Configurações
│       ├── nexConfig.js
│       └── aiConfig.js
├── templates/                    # Templates de documentos
│   ├── prd-template.md
│   ├── user-story-template.md
│   └── architecture-template.md
├── workflows/                    # Workflows pré-definidos
│   ├── greenfield/
│   └── brownfield/
├── docs/                         # Documentação adicional
├── sql/                          # Scripts SQL
└── package.json

🤖 Agentes

Agentes de Planejamento (Novos)

| Agente | Categoria | Função | |--------|-----------|--------| | ANX | FLX | Análise de requisitos e insights | | PMX | FLX | Gestão de produto e PRDs | | ARX | OPX | Arquitetura e design de sistemas | | DVX | AGX | Desenvolvimento e código | | DOCX | OPX | Documentação técnica | | QAX | ORDX | Qualidade e testes | | DEPX | AGX | Deploy e CI/CD | | MONX | ORDX | Monitoramento e observabilidade |

Agentes de Execução (Existentes)

| Categoria | Agentes | |-----------|---------| | ORDX | SupervisorAgent, PermissionAgent, ContextAgent, MemoryResourceAgent | | FLX | VoiceIntentAgent, QueryPlanningAgent, SuggestionAgent | | AGX | CompanyActionAgent, EmployeeActionAgent, CampaignActionAgent, ProspectingActionAgent, BenefitActionAgent, ProductActionAgent, IntegrationActionAgent | | OPX | DatabaseQueryAgent, DatabaseKnowledgeAgent, DataVisualizationAgent, FeedbackAgent |

Para documentação completa, veja: DOCUMENTACAO_AGENTES_NEX.md

💻 CLI

O NEX Framework inclui uma CLI completa para gerenciamento:

# Instalação (primeira vez)
npx nex-app@latest

# Comandos do Marketplace
nex agent search <query>        # Buscar agents
nex agent install <agent-id>    # Instalar agent  
nex agent list                  # Listar instalados
nex agent info <agent-id>       # Ver detalhes
nex agent update <agent-id>     # Atualizar agent
nex agent uninstall <agent-id>  # Remover agent

# Comandos de configuração
nex config                      # Ver configuração atual
nex config ai --provider openai # Configurar provider de IA

Para mais detalhes sobre o Marketplace: NEX_MARKETPLACE_SETUP.md

🏪 NEX Agent Marketplace

O NEX Agent Marketplace é um sistema completo de distribuição de agents:

Features:

• 📦 Registry Universal - Local + Git + Supabase
• 🔍 Search & Discovery - Busca por texto, tags, categoria
• ⚡ Instalação Rápida - nex agent install anx
• 🔗 Dependency Management - Auto-instalação de dependências
• 📊 Stats & Analytics - Tracking de instalações e uso
• ⭐ Reviews & Ratings - Sistema de feedback da comunidade
• 🎯 Official & Community - Agents oficiais INOSX + comunidade

Quick Start:

# 1. Instale o NEX (GRATUITO)
npx nex-app@latest

# 2. Buscar agents
nex agent search "planning"

# 3. Instalar agents
nex agent install anx

# 4. Ver instalados
nex agent list

Documentação completa: NEX_MARKETPLACE_SETUP.md

🔧 Configuração

Configuração de IA

Edite src/config/aiConfig.js para configurar seus providers:

export default {
  currentProvider: 'openai',
  providers: {
    openai: {
      apiKey: process.env.OPENAI_API_KEY,
      model: 'gpt-4o-mini'
    },
    claude: {
      apiKey: process.env.CLAUDE_API_KEY,
      model: 'claude-3-sonnet'
    }
    // ... outros providers
  }
}

Configuração de Agentes

Edite src/config/nexConfig.js para personalizar os agentes:

export const nexConfig = {
  supervisor: {
    minQualityScore: 70,
    maxRetries: 3
  },
  // ... outras configurações
}

🧪 Testes

# Executar testes
npm test

# Testes com cobertura
npm run test:coverage

# Testes rápidos
npm run test:quick

Consulte: GUIA_TESTES_NEX_ESPECIALISTA.md

🚧 Desenvolvimento

Requisitos

• Node.js >= 18.0.0
• npm ou yarn
• Git

Setup de Desenvolvimento

# Clone o repositório
git clone https://github.com/INOSX/nex-store.git
cd nex-store

# Instale dependências
npm install

# Configure variáveis de ambiente
cp .env.example .env
# Edite .env com suas credenciais do Supabase

# Configure Supabase (se ainda não fez)
supabase login
supabase link --project-ref your-project-ref
supabase db push

# Execute em modo desenvolvimento
npm run dev
# Frontend estará em http://localhost:3000

Para mais detalhes, consulte: docs/VITE_SUPABASE_SETUP.md

Estrutura de Branches

• main - Branch de produção
• develop - Branch de desenvolvimento

🤝 Contribuindo

Contribuições são bem-vindas! Por favor:

1. Fork o projeto
2. Crie uma branch para sua feature (git checkout -b feature/AmazingFeature)
3. Commit suas mudanças (git commit -m 'Add some AmazingFeature')
4. Push para a branch (git push origin feature/AmazingFeature)
5. Abra um Pull Request

Guia de Contribuição

• Siga o padrão de código existente
• Adicione testes para novas funcionalidades
• Atualize a documentação conforme necessário
• Use commits descritivos

📄 Licença

Este projeto é proprietário da INOSX (https://inosx.com). Todos os direitos reservados.

Este software e sua documentação são propriedade da INOSX e são fornecidos sob licença proprietária. É proibida a reprodução, distribuição, modificação ou uso comercial sem autorização expressa da INOSX.

Para mais informações sobre licenciamento, entre em contato através do site inosx.com.

👥 Autores

• INOSX - Desenvolvimento inicial - INOSX

🙏 Agradecimentos

• OpenAI pela API de IA
• Supabase pelo banco de dados
• Comunidade open source

📞 Suporte

• Issues: GitHub Issues
• Documentação: Veja a seção Documentação
• Email: [email protected]

🔗 Links Úteis

• Documentação Completa
• Padrão de Arquitetura
• Diagramas
• Fluxo do Sistema

⭐ Se este projeto foi útil para você, considere dar uma estrela!