Pular para o conteúdo principal
Versão: 1.0 beta

Quick Start

TL;DR​

Em 5–10 minutos, em um ambiente de desenvolvimento já preparado, você pode compilar o candidato, abrir a Web local, adicionar um projeto e iniciar uma AI Session. O exemplo usa o fluxo Direct, que não exige Composer, Flow ou Mission.

Estado em 18/10/2026: release/v1.0.0 com source 1.0.0-beta.10. A versão não equivale a v1 estável, instalador público ou plataforma homologada. O repositório está público; isso não significa que existam binários certificados. Veja release status. License: PolyForm Strict, uso não comercial sem alterações/redistribuição. Confirme providers com nexus doctor e nexus providers status --json.

1. Compile o candidato​

Para avaliação de desenvolvimento do código público, use a compilação do source. Não presuma que exista binário público certificado:

git clone https://github.com/IAPro-Community/nexus.git
cd nexus
bun install --cwd web --frozen-lockfile
make build
./nexus doctor

A instalação binária assinada passa a ser recomendada somente quando status de release registrar uma GitHub Release real.

2. Abra a workstation local​

./nexus web

Abra a URL de bootstrap que o comando mostrar. Ela é local e de curta duração; não a compartilhe. A Web usa loopback por padrão.

3. Registre um projeto e abra uma sessão​

Na Web:

  1. Abra Projects e adicione uma pasta de projeto.
  2. Selecione + New → AI Session.
  3. Escolha um provider que apareça disponível localmente.
  4. Trabalhe no terminal da sessão.

Alternativa de terminal:

cd /caminho/do/projeto
nexus projects add .
nexus codex

Substitua codex por um provider instalado. Não trate o exemplo como uma garantia de autenticação: use nexus providers status --json para confirmar o seu ambiente.

4. Confirme que funcionou​

nexus ps --json
nexus status

Você deve ver o runtime ou o perfil que acabou de usar. Se não aparecer, consulte troubleshooting.

Próximos passos​

Primeira execução assistida​

Ao abrir a interface, o cadastro do primeiro projeto consulta somente os endpoints locais já existentes de detecção de provedores e diagnóstico do sistema. A verificação não cria contas, modifica arquivos de configuração, executa login nem instala ferramentas de terceiros.

  • Se houver conta autenticada detectada, escolha uma pasta real em Procurar ou Localizar repositórios e abra uma AI Session.
  • Se uma CLI estiver instalada, mas ainda não tiver conta pronta, escolha Adicionar conta, confirme o perfil e conclua a autenticação através da seção Uso/Contas. Esse passo exige intervenção do usuário.
  • Se não houver CLI detectada, instale uma CLI de provedor compatível de uma fonte oficial; o Nexus não baixa executáveis nem solicita tokens automaticamente.
  • Se um diagnóstico não puder ser obtido, o cadastro de projeto continua disponível: falha de detecção não deve impedir trabalhar em um projeto.

Os antigos atalhos de projetos com caminhos absolutos fictícios foram removidos: cada projeto deve apontar para uma pasta selecionada no computador real. Quota, estimativa de custo, assinatura e fatura são conceitos diferentes; a primeira execução não os converte em crédito disponível.

No gerenciador de projetos, a pasta escolhida em Procurar agora é passada diretamente ao modal de cadastro. Atalhos chamados de templates, mas que não geravam estrutura de projeto nem selecionavam diretórios reais, foram retirados da interface até existir um mecanismo de scaffolding confiável.