CyberPaul/ratio-gemma3-4b-gguf-v8

RATIO — Ratio Decidendi Engine

ratio decidendi — o raciocínio jurídico por trás das decisões

Inteligência jurídica com seus dados sob seu controle.
100% local • 100% offline • 100% confidencial

Planos • Funcionalidades • Instalação • Arquitetura • Licenciamento

---

RATIO (/ˈrɑː.ti.oʊ/) — do latim ratio decidendi, o raciocínio jurídico que fundamenta uma decisão judicial.

O RATIO é um sistema de RAG (Retrieval-Augmented Generation) jurídico, local-first e 100% offline, projetado para advogados e escritórios de advocacia que demandam máxima confidencialidade no tratamento de seus documentos. O sistema extrai e analisa informações de múltiplos formatos de arquivos, permitindo interações em linguagem natural e rastreando de forma precisa a fundamentação legal de cada resposta diretamente no documento original.

---

🚀 v1.0.0 — Lançamento Oficial (Agosto 2026)

Componente	Status	URL
Software Desktop	✅	RATIO_Setup_v1.0.exe
License Server	✅	api.singularislabs.com.br
Landing Page	✅	ratio.singularislabs.com.br
Hotmart (4 planos)	✅	pay.hotmart.com/*
Email	✅	contato@singularislabs.com.br
Google Search Console	✅	Verificado
Google Analytics 4	✅	G-K7TG5J8G7L
Google Business Profile	✅	Singularis Labs
HuggingFace	✅	3 modelos publicados
SEO (7 páginas)	✅	Pillar pages + comparativos
INPI Registro	⏳	GRU paga, aguardando e-CNPJ

📊 Métricas de Produção

Métrica	Valor
Testes automatizados	622 (441 core + 180 license-server + 1 landing)
Bugs críticos	0
Camadas de segurança	13
Páginas SEO indexáveis	7
Modelos HuggingFace	3 (BERT + LoRA + GGUF)

---

🤖 IA Treinada — Classificador de Ratio Decidendi

Modelo	CyberPaul/ratio-bert-jurisprudencia-pt
Base	BERTimbau (neuralmind/bert-base-portuguese-cased)
Tarefa	Classificação binária: a sentença é ratio decidendi ou não?
Dados	20.266 sentenças balanceadas de 634.368 acórdãos do STJ e STF
F1-Score	99,55% (em sentenças) — estimativa de 93–97% em documentos inéditos
Licença	Apache 2.0

🛡️ Filtro de qualidade no pipeline

O classificador é integrado como guardião de qualidade da extração (processors/bert_ratio_filter.py). Cada sentença extraída é validada — cabeçalhos, relatórios, votações e dados processuais são removidos. Roda em lotes de 32 com detecção automática de device (DirectML → CUDA → CPU).

---

🧠 Fine-Tune Generativo — RATIO v8.2 + Gate

Base	unsloth/gemma-3-4b-it-bnb-4bit (QLoRA 4-bit)
Dataset	1.259 exemplos (700 RAG + 200 abstenção + 249 adversariais)
LoRA	CyberPaul/ratio-gemma3-4b-lora-v8 (277 MB)
GGUF	CyberPaul/ratio-gemma3-4b-gguf-v8 (Q4_K_M 2.49 GB)
Gate arquitetural	scripts/gate_rag.py — intercepta armadilhas antes do LLM

📊 Protocolo de Avaliação

Métrica	v8.2 + Gate	Threshold	Status
Faithfulness	0.983	≥ 0.85	✅
Citation Accuracy	0.997	≥ 0.90	✅
Unsupported Claims	0.058	≤ 0.10	✅
Hallucination Rate	0.000	≤ 0.10	✅
Utility Score	0.940	≥ 0.70	✅

Gate: ✅ APROVADO PARA PRODUÇÃO — Suite A (100/100) + Suite B (50/50) + Smoke Test (10/10)

Deploy no Ollama

python scripts/deploy_gguf_ollama.py
ollama list | grep ratio-gemma3

---

🌐 Landing Page Comercial

A landing page está online em ratio.singularislabs.com.br. Código-fonte em landing-page/RATIOlanding2/.

• Verificador de Compatibilidade de Hardware — sliders de RAM/VRAM + seletor de SO
• Showcase da IA treinada — métricas reais (99,55% F1)
• Planos, FAQ e Trial — tudo pronto para conversão
• SEO otimizado — meta tags, Open Graph e conteúdo semântico

🧪 Testes da landing page (Vitest)

A landing page possui 36 testes automatizados com cobertura de ~91%.

cd landing-page/RATIOlanding2
npm test

---

🎯 Planos e Preços

Recurso	🌱 TRIAL	⚡ SOLO	🏢 ESCRITÓRIO	🏛️ ENTERPRISE
Preço	Grátis	R$ 197/mês ou R$ 1.970/ano	R$ 497/mês ou R$ 4.970/ano	Sob consulta
Duração	14 dias	Mensal/Anual	Mensal/Anual	Perpétuo
Usuários	1	1	Até 5	Ilimitado
Bases	Até 3	Ilimitadas	Ilimitadas	Ilimitadas
RAG completo	✅	✅	✅	✅
Exportar PDF	✅	✅	✅	✅
OCR em imagens	✅	✅	✅	✅
Suporte prioritário	—	✅	✅	✅
Multi-usuário	—	—	✅	✅
API access	—	—	—	✅
Suporte dedicado	—	—	—	✅

🎁 Trial Grátis

Na primeira execução, o RATIO cria automaticamente uma licença TRIAL de 14 dias com todas as funcionalidades básicas. Sem necessidade de cartão de crédito.

---

✨ Funcionalidades

🔒 Privacidade Primeiro

• 100% offline — Seus documentos nunca saem do seu computador
• Sem APIs de terceiros — Todo processamento é local via Ollama
• LGPD compliant — Arquitetura desenhada para conformidade desde a fundação
• Hardware binding — Licença vinculada à máquina, sem risco de uso não autorizado

🧠 RAG Jurídico Inteligente

• Busca Híbrida — Busca semântica vetorial + BM25 para precisão máxima
• Chunking Semântico Jurídico — Divisão por Artigos, Parágrafos, Incisos e Cláusulas
• Streaming Token a Token — Respostas em tempo real via WebSocket
• Citação de Fontes — Referência exata ao documento e página
• Filtro BERT — IA própria que valida cada sentença extraída (99,55% F1)

📄 Ingestão Multi-Formato

• PDF (texto nativo + OCR para escaneados)
• DOCX, XLSX, PPTX (Word, Excel, PowerPoint)
• Imagens (PNG, JPG — OCR automático)
• URLs e YouTube (web scraping e transcrição automática)
• Google Drive (importação via OAuth2)
• OneDrive (importação via OAuth2)

🖥️ Interface Premium

• Onboarding interativo — Wizard de 5 passos na primeira execução
• Visualizador de PDF com highlight automático da página citada
• Chat com streaming e cards de fonte clicáveis
• Exportação de consultas em PDF
• Tema dark/light — Alternável com um clique

---

🏗️ Arquitetura

Projeto RATIO/
├── core/                    # Núcleo (auth, license, chunker, rag_engine, retriever)
├── engine/                  # Motor de inferência (llm_client, modelo_installer, exportador)
├── processors/              # Processadores (bert_ratio_filter, ratio_extractor)
├── scripts/                 # Pipeline de dados, treino e publicação
├── frontend/                # Interface React + TypeScript
├── tests/                   # 622 testes automatizados
├── license-server/          # Central de Licenças (webhook Hotmart, emails, painel)
├── landing-page/            # Landing page comercial (React + Vite)
├── installer/               # Instalador Windows (Inno Setup 6.3+)
├── api.py                   # Ponto de entrada FastAPI (HTTP + WebSocket)
├── iniciar.bat              # Execução com 1 clique
└── build_ratio.bat          # Build do instalador

---

🚀 Instalação

🖥️ Compatibilidade

Sistema Operacional	Status	Método
Windows 10/11	✅	Instalador (.exe) — RATIO_Setup_v1.0.exe
macOS 12+	✅	Script de instalação (bash)
Linux	✅	Script de instalação (bash)

🔧 Setup Automático (Recomendado)

SO	Comando
Windows	setup_ratio.bat
macOS	chmod +x install_mac.sh && ./install_mac.sh
Linux	chmod +x install_linux.sh && ./install_linux.sh

⚙️ Setup Manual

1. Pré-requisitos

• Python 3.10+ — python.org
• Node.js 18+ — nodejs.org
• Ollama — ollama.com
• Tesseract OCR (opcional, para PDFs escaneados)

2. Configurar Backend

pip install -r requirements.txt
copy .env.example .env

Edite o .env:

RATIO_API_KEY=sua_chave_secreta_aqui
OLLAMA_BASE_URL=http://localhost:11434
RATIO_MODELO=gemma3:4b
RATIO_NUM_CTX=4096
RATIO_HOST=127.0.0.1
RATIO_PORT=8000
RATIO_LICENSE_SERVER=https://api.singularislabs.com.br

3. Executar

Método recomendado: execute iniciar.bat — sobe Ollama, backend e frontend automaticamente.

Modo manual:

make run-api      # Terminal 1 — Backend (porta 8000)
make run-frontend  # Terminal 2 — Frontend (porta 5173)

Acesse: http://localhost:5173 🎉

---

🔐 Licenciamento

O RATIO tem licenciamento local (trial, ativação, hardware binding) com validação opcional contra a Central de Licenças (api.singularislabs.com.br).

Como funciona

1. Primeira execução → Trial de 14 dias criado automaticamente
2. Compra (Hotmart) → webhook cria a licença e a chave é enviada por email
3. Ativação → inserir chave na tela de licenciamento
4. Validação → integridade (checksum SHA256), hardware (MAC + username), data de expiração

Central de Licenças

Recurso	Detalhe
Webhook Hotmart	Venda cria licença, cancelamento/reembolso revoga
Emails automáticos	Chave pro cliente · aviso pro admin · lembretes de renovação
Ativação	POST /v1/activate — valida chave + hardware
Heartbeat	POST /v1/check — vigência/revogação em tempo real
Painel admin	/admin — vendas, receita, vencimentos, cadastro manual

Tipos de licença

Prefixo	Tipo	Duração	Recursos
RATIO-TRIAL-...	TRIAL	14 dias	Funcionalidades básicas
S...	SOLO	365 dias	RAG completo, bases ilimitadas
E...	ESCRITÓRIO	365 dias	Multi-usuário, prompts customizados
P...	ENTERPRISE	Perpétuo	API access, suporte dedicado

---

🔒 Segurança e Privacidade

• LGPD compliant — Dados nunca saem da máquina do usuário
• API Key timing-safe — Comparação em tempo constante (secrets.compare_digest)
• WebSocket autenticado — Validação de token no handshake
• Hardware binding — Licença vinculada ao hardware
• Grace period 72h — Cache encriptado para funcionar offline
• Rate limiting — 5 tentativas de ativação por hora
• Gate arquitetural — Intercepta perguntas que pedem confirmação de processo sem documento
• Dashboard de segurança — Monitoramento de tentativas de cracking em tempo real

---

🧪 Testes

# Toda a suíte (622 testes)
pytest tests/ -v

# Suíte completa com 1 clique (Windows)
run_tests.bat

# Testes específicos
pytest tests/test_license.py -v        # 26 testes de licenciamento
pytest tests/test_bert_filter.py -v    # Testes do filtro BERT
pytest tests/test_citation_checker.py -v  # Citation checker

---

🛠️ Comandos

Comando	Descrição
setup_ratio.bat	Configuração completa do ambiente
build_ratio.bat	Build: frontend + PyInstaller + Inno Setup
iniciar.bat	Execução com 1 clique (recomendado)
make run-api	Inicia backend FastAPI (porta 8000)
make run-frontend	Inicia frontend Vite (porta 5173)
run_tests.bat	Roda toda a suíte de testes

---

📞 Contato

Canal	Link
Site	ratio.singularislabs.com.br
Email	contato@singularislabs.com.br
GitHub	Churinti/singularis-labs (privado)
HuggingFace	CyberPaul
Hotmart	pay.hotmart.com

---

📜 Licença

O código-fonte do RATIO é proprietário. Os modelos publicados no HuggingFace possuem licenças específicas:

Modelo	Licença
ratio-bert-jurisprudencia-pt	Apache 2.0
ratio-gemma3-4b-lora-v8	Gemma Terms of Use
ratio-gemma3-4b-gguf-v8	Gemma Terms of Use
ratio-dataset-v8.1	Apache 2.0

---

Singularis Labs • São Gonçalo, RJ • CNPJ: 68.801.082/0001-07
ratio.singularislabs.com.br