🚀 NEX Framework

Framework completo de Agentes AI para desenvolvimento de software inteligente

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

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

# 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

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 (em breve)

npm install -g @nex/framework

🚀 Início Rápido

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

# 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

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:

# 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 <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

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:

# 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

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.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

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: [Adicione seu email de suporte]

🔗 Links Úteis

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

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