NEX CLI - Command-line interface for NEX Framework and Agent Marketplace
npm install nex-framework-clibash
Clone o repositório
git clone https://github.com/INOSX/nex.git
cd nex
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
`bash
npm install -g @nex/framework
`
🚀 Início Rápido
$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
Inicializar um novo projeto
nex init meu-projeto
Criar um plano completo
nex plan --requirements "Sistema de e-commerce"
Executar um workflow
nex workflow full-stack-app
Gerenciar agentes
nex agent list
nex agent install agent-id
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
Comandos principais
nex init # Inicializar projeto
nex plan # Criar plano de projeto
nex workflow # Executar workflows
nex store # Acessar NEX Store
nex config # Configurar framework
🆕 Agent Marketplace Commands
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
`
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
Buscar agents
nex agent search "planning"
Instalar
nex agent install anx
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.git
cd nex
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`)