Quickstart

Este guia coloca o Juca rodando na sua máquina com a configuração mínima necessária. Para uma configuração completa incluindo todos os serviços opcionais, veja Instalação.

Pré-requisitos

Node.js 20+ — verifique com node -v
npm — incluído no Node.js
Pelo menos uma chave de API de LLM (Anthropic recomendado)

1. Clonar e Instalar

git clone https://github.com/sensdiego/juca.git
cd juca
npm install

2. Configurar o Ambiente

Crie um arquivo .env.local com as variáveis mínimas necessárias:

# Obrigatório — pelo menos um provedor de LLM
ANTHROPIC_API_KEY=sk-ant-your-key-here
GROQ_API_KEY=gsk_your-key-here

# Ignorar autenticação no desenvolvimento local
ENABLE_DEV_AUTH=true

3. Iniciar o Servidor de Desenvolvimento

npm run dev

O servidor de desenvolvimento com Turbopack inicia em http://localhost:3000.

4. Primeira Interação

Abra http://localhost:3000 no seu navegador
Você verá o WorkCanvas com o Composer na parte inferior
Digite uma consulta jurídica, por exemplo: “Qual a jurisprudência do STJ sobre responsabilidade civil por dano moral?”
Observe os blocks aparecendo em tempo real via streaming SSE — o sistema detecta sua intenção, encaminha para a ferramenta adequada e renderiza os resultados estruturados

Scripts Disponíveis

Script	Comando	Finalidade
Servidor de dev	`npm run dev`	Inicia o servidor de desenvolvimento com Turbopack
Testes unitários	`npm test`	Roda os testes unitários com Vitest
Testes E2E	`npm run test:e2e`	Roda os testes E2E com Playwright
Lint	`npm run lint`	Verificação com ESLint
Cobertura	`npm run test:coverage`	Gera relatório de cobertura V8

Próximos Passos

Instalação Completa — Configure todos os serviços opcionais (Neo4j, serviço de embeddings, provedores de autenticação)
Variáveis de Ambiente — Referência completa para todas as 30+ variáveis de ambiente
Visão Geral da Arquitetura — Entenda como o modelo de hub do Juca funciona