Upload folder using huggingface_hub

README.md

@@ -0,0 +1,45 @@
+# Aletheia Noesis Decoder
+
+Noesis é o decoder proprietário da AletheiaEngine. Ele traduz estados simbólicos \(\psi_s\) em linguagem natural garantindo a coerência epistemológica medida pela **Qualidade da Verdade (Q)**. Diferente de abordagens puramente estatísticas, o Noesis prioriza a fidelidade semântica entre a intenção simbólica e o texto gerado.
+
+## Arquitetura
+
+- **Transformer Decoder** com 8 camadas e atenção cruzada condicionada por \(\psi_s\) e estados contínuos.
+- Entradas: vetor de intenção `psi_s`, memória lenta `state` opcional e sequência de tokens.
+- Saídas: `logits`, embedding semântico `z_text` e métrica \(\hat{Q}\).
+- Função de perda combina cross-entropy, coerência Q e penalizações de restrições.
+
+## API FastAPI
+
+O pacote inclui a aplicação `aletheia_decoder.api.app` com duas rotas:
+
+- `POST /generate`: recebe `psi_s`, `state`, `constraints`, prompts opcionais e parâmetros de decodificação. Retorna texto gerado, tokens, \(\hat{Q}\) e metadados.
+- `POST /train`: permite fine-tuning local a partir de um dataset JSONL.
+
+### Execução local
+
+```bash
+pip install -r requirements.txt
+uvicorn aletheia_decoder.api.app:app --host 0.0.0.0 --port 8000
+```
+
+## Treinamento
+
+Use o script `aletheia_decoder/model/train.py` para treinar o modelo com dados anotados:
+
+```bash
+python -m aletheia_decoder.model.train data/dataset.jsonl --epochs 200 --batch-size 4 --lr 3e-5
+```
+
+Os checkpoints podem ser salvos com `torch.save(model.state_dict(), "noesis.pt")` e exportados para ONNX se necessário.
+
+## Deploy no Hugging Face Spaces
+
+1. Faça fork deste diretório para um repositório separado.
+2. Configure o Space no modo **FastAPI** apontando para `app:app`.
+3. Defina as variáveis de ambiente de acordo com sua infraestrutura (ex.: `DECODER_ENDPOINT`).
+4. Opcionalmente publique checkpoints `.pt` e `.onnx` nos assets do Space.
+
+## Slogan
+
+> **Noesis — onde a intenção se torna linguagem.**

model_infer.onnx

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:1154ef7aefd95931fcfb7c882cac57d258b340c4971eb62394e69a8e54570370
+size 1605756

noesis.pt

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:a0819b6a076be07ffb89add5a3dbd8337c07e05ae7e08319e5f7dc0c4fd27a19
+size 507122536

requirements.txt

@@ -0,0 +1,5 @@
+fastapi>=0.110
+uvicorn[standard]>=0.23
+pydantic>=2.6
+torch>=2.1
+numpy>=1.24