NEX 2.0 - Multi-LLM AI Framework with Cursor Rules Integration | The easiest way to use AI agents in your development workflow
npm install nex-app.cursor/rules/nex/
bash
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
$3
- 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
$3
- 18 agentes especializados para execução de comandos
- Sistema de orquestração multi-agente
- Validação multi-camada
- Busca semântica com vetorização
$3
- 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
$3
- 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
$3
- 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
$3
`bash
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
`
$3
- 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)
$3
`bash
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
`
$3
1. Crie um projeto no Supabase
2. Execute as migrations:
`bash
# 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:
`bash
supabase functions deploy nex-store-auth
supabase functions deploy nex-store-agents
supabase functions deploy nex-manager-api
`
$3
O NEX Framework é instalado automaticamente via NPX. Para usuários que precisam instalar globalmente:
`bash
Instalar NEX CLI globalmente (opcional)
npm install -g nex-app@latest
`
🚀 Início Rápido
$3
`bash
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
`
$3
`bash
Iniciar servidor de desenvolvimento (Vite)
npm run dev
O frontend estará disponível em http://localhost:3000
`
$3
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
$3
`bash
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
`
$3
`javascript
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
$3
- Frontend: Vite + React (deploy no Vercel)
- Backend: Supabase Edge Functions (Deno)
- Banco de Dados: Supabase PostgreSQL
- Autenticação: Supabase Auth
- Storage: Supabase Storage
$3
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
$3
- 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
$3
- 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
$3
| 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 |
$3
| 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:
`bash
Instalação (primeira vez)
npx nex-app@latest
Comandos do Marketplace
nex agent search # Buscar agents
nex agent install # Instalar agent
nex agent list # Listar instalados
nex agent info # Ver detalhes
nex agent update # Atualizar agent
nex agent uninstall # 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:
`bash
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
$3
Edite src/config/aiConfig.js para configurar seus providers:
`javascript
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
}
}
`
$3
Edite src/config/nexConfig.js para personalizar os agentes:
`javascript
export const nexConfig = {
supervisor: {
minQualityScore: 70,
maxRetries: 3
},
// ... outras configurações
}
`
🧪 Testes
`bash
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
$3
- Node.js >= 18.0.0
- npm ou yarn
- Git
$3
`bash
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
$3
- 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`)