ratio-gemma3-4b-gguf-v8

<p align="center"> <img src="logo.png" alt="RATIO" width="100"> </p> <h1 align="center">RATIO — Ratio Decidendi Engine</h1> <p align="center"><em>ratio decidendi</em> — o raciocínio jurídico por trás das decisões</p> <p align="center"> <em>Inteligência jurídica com seus dados sob seu controle.</em><br/> <strong>100% local • 100% offline • 100% confidencial</strong> </p> <p align="center"> <a href="#-planos-e-preços">Planos</a> • <a href="#-funcionalidades">Funcionalidades</a> • <a href="#-instalação">Instalação</a> • <a href="#-arquitetura">Arquitetura</a> • <a href="#-licenciamento">Licenciamento</a> </p>

---

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)

📊 Métricas de Produção

---

🤖 IA Treinada — Classificador de Ratio Decidendi

🛡️ 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

📊 Protocolo de Avaliação

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

🎁 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

🔧 Setup Automático (Recomendado)

⚙️ 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

Tipos de licença

---

🔒 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

---

📞 Contato

---

📜 Licença

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

---

<p align="center"> <strong>Singularis Labs</strong> • São Gonçalo, RJ • CNPJ: 68.801.082/0001-07<br/> <a href="https://ratio.singularislabs.com.br">ratio.singularislabs.com.br</a> </p>