Skip to content
sens Juca

Quickstart

Quickstart

Section titled “Quickstart”

This guide gets Juca running on your machine with the minimum viable configuration. For a complete setup including all optional services, see Installation.

Prerequisites

Section titled “Prerequisites”
  • Node.js 20+ — verify with node -v
  • npm — ships with Node.js
  • At least one LLM API key (Anthropic recommended)

1. Clone and Install

Section titled “1. Clone and Install”
Terminal window
git clone https://github.com/sensdiego/juca.git
cd juca
npm install

2. Configure Environment

Section titled “2. Configure Environment”

Create a .env.local file with the minimum required variables:

Terminal window
# Required — at least one LLM provider
ANTHROPIC_API_KEY=sk-ant-your-key-here
GROQ_API_KEY=gsk_your-key-here


# Skip authentication for local development
ENABLE_DEV_AUTH=true

3. Start the Dev Server

Section titled “3. Start the Dev Server”
Terminal window
npm run dev

The Turbopack dev server starts at http://localhost:3000.

4. First Interaction

Section titled “4. First Interaction”
  1. Open http://localhost:3000 in your browser
  2. You’ll see the WorkCanvas with the Composer input at the bottom
  3. Type a legal query, e.g.: “Qual a jurisprudência do STJ sobre responsabilidade civil por dano moral?”
  4. Watch as blocks appear in real-time via SSE streaming — the system detects your intent, routes to the appropriate tool, and renders structured results

Available Scripts

Section titled “Available Scripts”
ScriptCommandPurpose
Dev servernpm run devStart Turbopack dev server
Unit testsnpm testRun Vitest unit tests
E2E testsnpm run test:e2eRun Playwright E2E tests
Lintnpm run lintESLint check
Coveragenpm run test:coverageGenerate V8 coverage report

Next Steps

Section titled “Next Steps”