README.md

---
license: other
license_name: virtuo
license_link: https://justina.cloud/licenses_models/virtuo/virtuo_1_0.txt
datasets:
- VirtuoTuring/justina_clarus
language:
- pt
base_model:
- VirtuoTuring/Chat_Noir
tags:
- legal
- civil-procedure
- civil-code
- abuso-de-direito
- liberdade-sexual
- ação-popular
- ação-coletiva
- gguf
---
---

# Justina Clarus 24B — GGUF

Modelo conversacional PT-PT focado em CPC e CC, com reforço intensivo em:
- abuso de direito,
- direito da família,
- direito de liberdade sexual,
- ações coletivas (subtipo popular).

Distribuição em **GGUF** para execução local com `llama.cpp`/`llama-cpp-python`.

## Origem

**Base:** Chat Noir — desenvolvido por Octávio Viana com Virtuo Turing – Artificial Intelligence, S.A.  
Arquitetura: Mistral-24B com LoRA proprietárias. Corpus PT-PT técnico, jurídico e literário.

## Cobertura jurídica

- **CPC**: espécies de ações, processos, competência, recursos, caso julgado.
- **CC**: obrigações, responsabilidade civil, direitos de personalidade.
- Reforços: abuso de direito; família e menores; liberdade sexual; ações populares.
- Contexto alargado (seleção): CPP, CP, CRP, CEDH, RGPD (+ Lei 58/2019), Lei 112/2009, Lei 130/2015, LAV, Reg. (UE) 1215/2012, Reg. (UE) 2019/1111, Dir. 2004/25/CE, CVM 194/196.

## Dados e metodologia

Treino em **JSONL** com pares Q/A autossuficientes.

- `role`: "user" ou "assistant".
- `content`: texto simples em PT-PT. Sem cabeçalhos. Sem vírgulas finais.
- **Schema**
  { "messages": [ {"role":"user","content":"…"}, {"role":"assistant","content":"…"} ] }

**Exemplos**
{"messages":[{"role":"user","content":"Quais são as espécies fundamentais de ações no Direito Processual Civil segundo o artigo 10.º, n.º1 CPC?"},{"role":"assistant","content":"Segundo o artigo 10.º, n.º1 CPC, no esquema de Direito Processual Civil, há duas espécies fundamentais de ações."}]}
{"messages":[{"role":"user","content":"O que caracteriza a ação declarativa no Direito Processual Civil?"},{"role":"assistant","content":"A ação declarativa pode ainda ser, conforme o artigo 10.º, n.º2 e 3 CPC, de simples apreciação, de condenação ou constitutiva, sendo que em cada subespécie se pedem diferentes providências ao tribunal."}]}

**Treino jurídico adicional (síntese)**  
Peças processuais iniciais e acórdãos das Relações (Guimarães, Porto, Coimbra, Lisboa, Évora) e STJ, convertidos em Q/A, checklists, testes binários, contraexemplos e “ruído controlado”.

## Design e limites

- Respostas curtas e precisas; baixa latência local.
- Janela de contexto ≈ 4k tokens.
- Quantizações GGUF típicas: Q4_K_S, Q5, Q8.
- Não otimizado para contexto longo (>8k).

## Utilização

### `llama.cpp`
./main -m justina_clarus-24b.Q4_K_S.gguf -n 512 -t 8 -ngl 35 --prompt "Pergunta: Indique as espécies de ações no art. 10.º, n.º 1 CPC.\nResposta:"

### `llama-cpp-python`
Recomendado: `llama_cpp_python==0.3.9`, `numpy==1.26.4`.

from llama_cpp import Llama
llm = Llama(model_path="justina_clarus-24b.Q4_K_S.gguf", n_ctx=4096, n_threads=8, n_gpu_layers=35)
out = llm("Pergunta: Quais são as espécies fundamentais de ações no art. 10.º, n.º 1 CPC?\nResposta:", max_tokens=400, temperature=0.2, top_p=0.9)
print(out["choices"][0]["text"].strip())

## Boas práticas

- Citar artigos e números quando relevante.
- Validar com fontes oficiais e revisão humana em peças processuais.

## Avaliação

Sem métricas públicas nesta versão. Uso alvo: Q/A jurídico, síntese curta, esboços.

## Limitações

- Não substitui profissionais forenses ou tribunais.
- Pode errar em regimes especiais ou alterações legislativas recentes.

## Licença

**Virtuo 1.0**. Uso, modificação e redistribuição, incluindo comercial, desde que se preservem avisos originais e referência a **Virtuo Turing – Artificial Intelligence, S.A.**.

## Créditos

Virtuo Turing – Artificial Intelligence, S.A. (Portugal) e Octávio Viana.  
Base © Mistral AI (Apache-2.0).  
Website: https://justina.cloud

## Citação sugerida

VirtuoTuring/justina_clarus-24b-gguf — Chat Noir PT-PT jurídico (CPC/CC; abuso de direito; família; liberdade sexual; ações populares). Virtuo Turing – Artificial Intelligence, S.A.


# Justina Clarus 24B — GGUF

PT-PT conversational model focused on the Portuguese Civil Procedure Code (CPC) and Civil Code (CC), with intensive subsets on:
- abuse of rights,
- family law,
- sexual freedom–related offences,
- collective actions of the “popular action” subtype.

Distributed as **GGUF** for local inference via `llama.cpp`/`llama-cpp-python`.

## Origin

**Base:** Chat Noir — developed by Octávio Viana with Virtuo Turing – Artificial Intelligence, S.A.  
Architecture: Mistral-24B with proprietary LoRA adapters. Corpus authored in European Portuguese across technical, legal, and literary domains.

## Legal coverage

- **CPC**: types of actions, procedures, jurisdiction, appeals, res judicata.
- **CC**: obligations, tort, personality rights.
- Reinforcements: abuse of rights; family and minors; sexual freedom; popular actions.
- Wider context (selection): CPP, CP, CRP, ECHR, GDPR (+ Law 58/2019), Law 112/2009, Law 130/2015, LAV, Reg. (EU) 1215/2012, Reg. (EU) 2019/1111, Directive 2004/25/EC, CVM 194/196.

## Data and method

Training in **JSONL** using self-contained Q/A pairs.

- `role`: "user" or "assistant".
- `content`: plain PT-PT text. No headers. No trailing commas.
- **Schema**
  { "messages": [ {"role":"user","content":"…"}, {"role":"assistant","content":"…"} ] }

**Examples**
{"messages":[{"role":"user","content":"Quais são as espécies fundamentais de ações no Direito Processual Civil segundo o artigo 10.º, n.º1 CPC?"},{"role":"assistant","content":"Segundo o artigo 10.º, n.º1 CPC, no esquema de Direito Processual Civil, há duas espécies fundamentais de ações."}]}
{"messages":[{"role":"user","content":"O que caracteriza a ação declarativa no Direito Processual Civil?"},{"role":"assistant","content":"A ação declarativa pode ainda ser, conforme o artigo 10.º, n.º2 e 3 CPC, de simples apreciação, de condenação ou constitutiva, sendo que em cada subespécie se pedem diferentes providências ao tribunal."}]}

**Additional legal training (summary)**  
Statements of claim and Portuguese appellate and Supreme Court judgments, converted into Q/A, checklists, binary tests, counterexamples, and “controlled noise”.

## Design and limits

- Short, precise answers; low latency on local hardware.
- Context window ≈ 4k tokens.
- Typical GGUF quantizations: Q4_K_S, Q5, Q8.
- Not tuned for long-context reasoning (>8k).

## Usage

### `llama.cpp`
./main -m justina_clarus-24b.Q4_K_S.gguf -n 512 -t 8 -ngl 35 --prompt "Pergunta: Indique as espécies de ações no art. 10.º, n.º 1 CPC.\nResposta:"

### `llama-cpp-python`
Recommended: `llama_cpp_python==0.3.9`, `numpy==1.26.4`.

from llama_cpp import Llama
llm = Llama(model_path="justina_clarus-24b.Q4_K_S.gguf", n_ctx=4096, n_threads=8, n_gpu_layers=35)
out = llm("Pergunta: Quais são as espécies fundamentais de ações no art. 10.º, n.º 1 CPC?\nResposta:", max_tokens=400, temperature=0.2, top_p=0.9)
print(out["choices"][0]["text"].strip())

## Good practice

- Cite article numbers when relevant.
- Validate outputs against official sources; require human review for filings.

## Evaluation

No public metrics in this card. Target use: legal Q/A, brief synthesis, drafting support.

## Limitations

- Not a substitute for legal professionals or courts.
- May miss special regimes or recent legislative changes.

## License

**Virtuo 1.0**. Permissive use, modification, and redistribution, including commercial, provided original notices are preserved and **Virtuo Turing – Artificial Intelligence, S.A.** is referenced.

## Credits

Virtuo Turing – Artificial Intelligence, S.A. (Portugal) and Octávio Viana.  
Base © Mistral AI (Apache-2.0).  
Website: https://justina.cloud

## Suggested citation

VirtuoTuring/justina_clarus-24b-gguf — Chat Noir PT-PT legal model (CPC/CC; abuse of rights; family; sexual freedom; popular actions). Virtuo Turing – Artificial Intelligence, S.A.