serigy 0.2.0__tar.gz

serigy-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wendell Barreto
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

serigy-0.2.0/PKG-INFO

@@ -0,0 +1,131 @@
+Metadata-Version: 2.4
+Name: serigy
+Version: 0.2.0
+Summary: Inference-only PT-BR typed predictors (load Hub weights + predict / system_one)
+Author-email: Wendell Barreto <wendellbarreto@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/wendellbigato/serigy-jev
+Project-URL: Hugging Face, https://huggingface.co/wendellperbar/serigy-jev
+Project-URL: Hugging Face Golpes BR, https://huggingface.co/wendellperbar/serigy-golpes-br
+Project-URL: Hugging Face T-Rex, https://huggingface.co/wendellperbar/serigy-trex
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.26.0
+Requires-Dist: pydantic>=2.5.0
+Requires-Dist: torch
+Requires-Dist: transformers>=4.40.0
+Requires-Dist: sentence-transformers>=3.0.0
+Requires-Dist: safetensors>=0.4.0
+Requires-Dist: huggingface_hub>=0.24.0
+Requires-Dist: python-dotenv>=1.0.0
+Dynamic: license-file
+
+<p align="center">
+  <img src="assets/brand/simbolo_transparente.png" alt="Serigy" width="140"/>
+</p>
+
+# Serigy
+
+Classificador local de fake news em PT-BR. Carrega pesos do Hub e faz `predict`.
+Também expõe primitivos System One: **Escolha**, **Indice**, **Verdadeiro**, **Prioridade**.
+
+Marca: [`assets/brand/`](assets/brand/) · [spec](.cursor/specs/marca/spec.md).
+
+```bash
+pip install serigy
+```
+
+```python
+from serigy import SerigyModel
+
+model = SerigyModel("wendellperbar/serigy-jev")
+out = model.predict(
+    "Senado aprova lei que PROÍBE jogo de videogame para menores de 18 anos."
+)
+print(out["predicao"], out["score_final"], out["confianca_calibrada"])
+```
+
+```bash
+serigy --texto "texto da notícia..."
+```
+
+Se o sensor for gated, configure `HF_TOKEN`.
+
+### Saída (`predict` = Prioridade)
+
+| Campo | Significado |
+|-------|-------------|
+| `predicao` | `Claramente Falso` / `Incerto/Misto` / `Claramente Verdadeiro` |
+| `classe_ordinal` | `0`, `1` ou `2` |
+| `score_final` | veracidade `0.0`…`1.0` |
+| `confianca_calibrada` | perto de `1` = mais concentrado |
+| `probabilidades` | massa em cada classe |
+
+Critérios usam `type: "prioridade"` (alias de input: `ordinal_score`).
+
+### System One (`system_one`)
+
+```python
+from serigy import SerigyModel, Escolha, Indice, Verdadeiro, Prioridade
+
+model = SerigyModel("wendellperbar/serigy-jev")
+result = model.system_one(
+    "texto a avaliar…",
+    {
+        "rota": Escolha(
+            instructions="Qual ação?",
+            criteria={"abaixar": None, "fazer_nada": None, "pular": None},
+        ),
+        "nivel": Indice(
+            instructions="Quão grave?",
+            criteria=["Baixa", "Média", "Alta"],
+        ),
+        "eh_fato": Verdadeiro(instructions="É verdadeira?"),
+    },
+)
+print(result.answers["rota"].escolha, result.answers["eh_fato"].verdadeiro)
+# JSON público: result.as_public_dict()
+```
+
+| Jev | Serigy | O que responde |
+|-----|--------|----------------|
+| Choice | `escolha` | Qual opção (conjunto fechado)? |
+| Score | `indice` | Em que ponto do espectro (K∈[2,10])? |
+| Noul | `verdadeiro` | A proposição é verdadeira? (P(sim)) |
+| — | `prioridade` | Em qual de 3 patamares? (`predict` é atalho) |
+
+CLI System One: `serigy --json '{"state":"…","questions":{…}}'`.
+
+Spec pública: [`.cursor/specs/sdk-primitivos/spec.md`](.cursor/specs/sdk-primitivos/spec.md).
+
+Pesos FakeNews: [huggingface.co/wendellperbar/serigy-jev](https://huggingface.co/wendellperbar/serigy-jev)
+
+### Golpes BR (System One)
+
+Heads multi-task para mensagens de golpe/legítimas em PT-BR (staging `hf/golpes/` → Hub `wendellperbar/serigy-golpes-br`):
+
+```python
+from serigy import SerigyModel, Escolha, Verdadeiro
+
+model = SerigyModel("wendellperbar/serigy-golpes-br")
+result = model.system_one(
+    "Confirme seu CPF neste link para liberar o PIX…",
+    {
+        "acao": Escolha(
+            instructions="Como tratar?",
+            criteria={"bloquear": None, "revisar": None, "entregar": None},
+        ),
+        "eh_golpe": Verdadeiro(instructions="É golpe?"),
+    },
+)
+```
+
+Sync / upload: [`hf/README.md`](hf/README.md) · card [`hf/golpes/README.md`](hf/golpes/README.md).
+
+### Extra: benchmark T-Rex (monorepo)
+
+Comparativo Serigy × Jev × Laya no Chrome T-Rex Runner (`serigy_trex`):  
+[src/serigy_trex/README.md](src/serigy_trex/README.md) · [docs/RELATORIO_TREX.md](docs/RELATORIO_TREX.md) · [spec](.cursor/specs/trex-benchmark/spec.md).
+
+MIT — Copyright © 2026 Wendell Barreto.

serigy-0.2.0/README.md

@@ -0,0 +1,108 @@
+<p align="center">
+  <img src="assets/brand/simbolo_transparente.png" alt="Serigy" width="140"/>
+</p>
+
+# Serigy
+
+Classificador local de fake news em PT-BR. Carrega pesos do Hub e faz `predict`.
+Também expõe primitivos System One: **Escolha**, **Indice**, **Verdadeiro**, **Prioridade**.
+
+Marca: [`assets/brand/`](assets/brand/) · [spec](.cursor/specs/marca/spec.md).
+
+```bash
+pip install serigy
+```
+
+```python
+from serigy import SerigyModel
+
+model = SerigyModel("wendellperbar/serigy-jev")
+out = model.predict(
+    "Senado aprova lei que PROÍBE jogo de videogame para menores de 18 anos."
+)
+print(out["predicao"], out["score_final"], out["confianca_calibrada"])
+```
+
+```bash
+serigy --texto "texto da notícia..."
+```
+
+Se o sensor for gated, configure `HF_TOKEN`.
+
+### Saída (`predict` = Prioridade)
+
+| Campo | Significado |
+|-------|-------------|
+| `predicao` | `Claramente Falso` / `Incerto/Misto` / `Claramente Verdadeiro` |
+| `classe_ordinal` | `0`, `1` ou `2` |
+| `score_final` | veracidade `0.0`…`1.0` |
+| `confianca_calibrada` | perto de `1` = mais concentrado |
+| `probabilidades` | massa em cada classe |
+
+Critérios usam `type: "prioridade"` (alias de input: `ordinal_score`).
+
+### System One (`system_one`)
+
+```python
+from serigy import SerigyModel, Escolha, Indice, Verdadeiro, Prioridade
+
+model = SerigyModel("wendellperbar/serigy-jev")
+result = model.system_one(
+    "texto a avaliar…",
+    {
+        "rota": Escolha(
+            instructions="Qual ação?",
+            criteria={"abaixar": None, "fazer_nada": None, "pular": None},
+        ),
+        "nivel": Indice(
+            instructions="Quão grave?",
+            criteria=["Baixa", "Média", "Alta"],
+        ),
+        "eh_fato": Verdadeiro(instructions="É verdadeira?"),
+    },
+)
+print(result.answers["rota"].escolha, result.answers["eh_fato"].verdadeiro)
+# JSON público: result.as_public_dict()
+```
+
+| Jev | Serigy | O que responde |
+|-----|--------|----------------|
+| Choice | `escolha` | Qual opção (conjunto fechado)? |
+| Score | `indice` | Em que ponto do espectro (K∈[2,10])? |
+| Noul | `verdadeiro` | A proposição é verdadeira? (P(sim)) |
+| — | `prioridade` | Em qual de 3 patamares? (`predict` é atalho) |
+
+CLI System One: `serigy --json '{"state":"…","questions":{…}}'`.
+
+Spec pública: [`.cursor/specs/sdk-primitivos/spec.md`](.cursor/specs/sdk-primitivos/spec.md).
+
+Pesos FakeNews: [huggingface.co/wendellperbar/serigy-jev](https://huggingface.co/wendellperbar/serigy-jev)
+
+### Golpes BR (System One)
+
+Heads multi-task para mensagens de golpe/legítimas em PT-BR (staging `hf/golpes/` → Hub `wendellperbar/serigy-golpes-br`):
+
+```python
+from serigy import SerigyModel, Escolha, Verdadeiro
+
+model = SerigyModel("wendellperbar/serigy-golpes-br")
+result = model.system_one(
+    "Confirme seu CPF neste link para liberar o PIX…",
+    {
+        "acao": Escolha(
+            instructions="Como tratar?",
+            criteria={"bloquear": None, "revisar": None, "entregar": None},
+        ),
+        "eh_golpe": Verdadeiro(instructions="É golpe?"),
+    },
+)
+```
+
+Sync / upload: [`hf/README.md`](hf/README.md) · card [`hf/golpes/README.md`](hf/golpes/README.md).
+
+### Extra: benchmark T-Rex (monorepo)
+
+Comparativo Serigy × Jev × Laya no Chrome T-Rex Runner (`serigy_trex`):  
+[src/serigy_trex/README.md](src/serigy_trex/README.md) · [docs/RELATORIO_TREX.md](docs/RELATORIO_TREX.md) · [spec](.cursor/specs/trex-benchmark/spec.md).
+
+MIT — Copyright © 2026 Wendell Barreto.

serigy-0.2.0/pyproject.toml

@@ -0,0 +1,77 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "serigy"
+version = "0.2.0"
+description = "Inference-only PT-BR typed predictors (load Hub weights + predict / system_one)"
+readme = "README.md"
+license = "MIT"
+authors = [{ name = "Wendell Barreto", email = "wendellbarreto@gmail.com" }]
+requires-python = ">=3.14"
+dependencies = [
+    "numpy>=1.26.0",
+    "pydantic>=2.5.0",
+    "torch",
+    "transformers>=4.40.0",
+    "sentence-transformers>=3.0.0",
+    "safetensors>=0.4.0",
+    "huggingface_hub>=0.24.0",
+    "python-dotenv>=1.0.0",
+]
+
+[project.scripts]
+serigy = "serigy.__main__:main"
+
+[project.urls]
+Homepage = "https://github.com/wendellbigato/serigy-jev"
+"Hugging Face" = "https://huggingface.co/wendellperbar/serigy-jev"
+"Hugging Face Golpes BR" = "https://huggingface.co/wendellperbar/serigy-golpes-br"
+"Hugging Face T-Rex" = "https://huggingface.co/wendellperbar/serigy-trex"
+
+# Wheel/sdist = apenas inferência. serigy_train / serigy_trex ficam no git
+# (pythonpath) e são removidos de novo no publish.yml por segurança.
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["serigy", "serigy.*"]
+exclude = ["serigy_train", "serigy_train.*", "serigy_trex", "serigy_trex.*"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+markers = [
+    "smoke: integração real (checkpoint + sensor); requer RUN_SMOKE=1",
+]
+
+[dependency-groups]
+dev = [
+    "ipykernel>=7.3.0",
+    "pytest>=8.0.0",
+]
+# Monorepo only (não vai no METADATA do PyPI):
+train = [
+    "mlx>=0.31.2",
+    "mlx-lm>=0.31.0",
+    "datasets>=3.6,<4",
+    "scikit-learn>=1.4.0",
+    "tqdm>=4.66.0",
+]
+bench = [
+    "typesafe-sdk>=0.1.0",
+    "pandas>=2.0.0",
+    "matplotlib>=3.8.0",
+    "seaborn>=0.13.0",
+    "ipywidgets>=8.0.0",
+    "jupyter>=1.0.0",
+    "laya>=0.3.3",
+]
+# T-Rex arena / dataset / vídeo (spec trex-benchmark; fora do wheel PyPI)
+trex = [
+    "pillow>=10.0.0",
+    "imageio>=2.34.0",
+    "imageio-ffmpeg>=0.5.0",
+    "tqdm>=4.66.0",
+    "typesafe-sdk>=0.1.0",
+    "laya>=0.3.3",
+]

serigy-0.2.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

serigy-0.2.0/src/serigy/__init__.py

@@ -0,0 +1,44 @@
+"""Serigy — inferência pública (pip).
+
+Uso:
+    from serigy import SerigyModel, Escolha, Verdadeiro
+    model = SerigyModel("wendellperbar/serigy-jev")
+    out = model.predict("texto da notícia...")
+    result = model.system_one(state, {"q": Verdadeiro(instructions="…?")})
+
+Após cada upload no Hub, atualize DEFAULT_HUB_REVISION em cliente.py
+(pin atual: 785ef7e842fb82409af027b4f9ee217a4e72f9d7).
+"""
+
+from __future__ import annotations
+
+from serigy.cliente import DEFAULT_REPO, SerigyModel
+from serigy.primitivos.schemas import (
+    Escolha,
+    Indice,
+    Prioridade,
+    SystemOneRequest,
+    SystemOneResult,
+    Verdadeiro,
+)
+
+__all__ = [
+    "SerigyModel",
+    "DEFAULT_REPO",
+    "Escolha",
+    "Indice",
+    "Verdadeiro",
+    "Prioridade",
+    "SystemOneRequest",
+    "SystemOneResult",
+]
+
+try:
+    from importlib.metadata import PackageNotFoundError, version
+
+    try:
+        __version__ = version("serigy")
+    except PackageNotFoundError:
+        __version__ = "0.2.0"
+except ImportError:  # pragma: no cover
+    __version__ = "0.2.0"

serigy-0.2.0/src/serigy/__main__.py

@@ -0,0 +1,112 @@
+"""CLI: python -m serigy --texto "..." | --json '{...}' | --stdin."""
+
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+from pathlib import Path
+from typing import Any
+
+from serigy.cliente import DEFAULT_REPO, SerigyModel, _saida_publica_system_one
+from serigy.primitivos.schemas import SystemOneRequest
+
+
+def _carregar_json(args: argparse.Namespace) -> dict[str, Any]:
+    if args.stdin:
+        return json.load(sys.stdin)
+    assert args.json is not None
+    raw = args.json
+    caminho = Path(raw)
+    if caminho.is_file():
+        return json.loads(caminho.read_text(encoding="utf-8"))
+    return json.loads(raw)
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = argparse.ArgumentParser(
+        prog="serigy",
+        description="Inferência Serigy (schema público I/O)",
+    )
+    parser.add_argument(
+        "texto_posicional",
+        nargs="?",
+        default=None,
+        help="Texto da notícia (alternativa a --texto)",
+    )
+    parser.add_argument("--texto", default=None, help="Texto da notícia (predict)")
+    parser.add_argument("--fonte", default=None, help="Fonte opcional (predict)")
+    parser.add_argument(
+        "--json",
+        default=None,
+        help="System One: JSON (arquivo ou string) com state + questions",
+    )
+    parser.add_argument(
+        "--stdin",
+        action="store_true",
+        help="System One: ler envelope JSON de stdin",
+    )
+    parser.add_argument(
+        "--model",
+        default=DEFAULT_REPO,
+        help=f"Hub id ou pasta local (default: {DEFAULT_REPO})",
+    )
+    parser.add_argument(
+        "--revision",
+        default=None,
+        help="Revision Hub (commit/tag); default: SERIGY_HUB_REVISION / pin do pacote",
+    )
+    parser.add_argument(
+        "--allow-custom-models",
+        action="store_true",
+        help="Permite model_id/embedding fora da allowlist (só se confiar no checkpoint)",
+    )
+    parser.add_argument(
+        "--hf-token",
+        default=None,
+        help="Token HF (ou env HF_TOKEN)",
+    )
+    parser.add_argument(
+        "--warm",
+        action="store_true",
+        help="Pré-carrega o sensor antes da predição",
+    )
+    args = parser.parse_args(argv)
+
+    modo_system_one = bool(args.json or args.stdin)
+    texto = args.texto or args.texto_posicional
+    if modo_system_one and texto:
+        parser.error("use --texto OU --json/--stdin, não ambos")
+    if not modo_system_one and not texto:
+        parser.error("informe --texto, argumento posicional, --json ou --stdin")
+
+    print(f"carregando {args.model}…", file=sys.stderr)
+    model = SerigyModel(
+        args.model,
+        token=args.hf_token,
+        warm=args.warm,
+        revision=args.revision,
+        allow_custom_models=args.allow_custom_models,
+    )
+
+    if modo_system_one:
+        payload = _carregar_json(args)
+        req = SystemOneRequest.model_validate(payload)
+        result = model.system_one(req.state, req.questions)
+        out = _saida_publica_system_one(result)
+        print(json.dumps(out, ensure_ascii=False, indent=2))
+        return 0
+
+    out = model.predict(texto, fonte=args.fonte)
+    print(
+        f"→ {out['predicao']}  |  classe={out['classe_ordinal']}  "
+        f"|  score={out['score_final']:.3f}  "
+        f"|  confiança={out['confianca_calibrada']:.3f}",
+        file=sys.stderr,
+    )
+    print(json.dumps(out, ensure_ascii=False, indent=2))
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

serigy-0.2.0/src/serigy/api/__init__.py

@@ -0,0 +1,46 @@
+"""Schemas + motor de inferência (uso interno; API pública = SerigyModel)."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any
+
+from serigy.api.schemas import (
+    ComponentesConfianca,
+    CriteriosAvaliacao,
+    InputEco,
+    MetricasInferencia,
+    NivelOrdinal,
+    Noticia,
+    NoticiaRequest,
+    OutputPredicao,
+    PesosComponentes,
+    PredicaoResponse,
+    ProbabilidadesOrdinais,
+)
+
+if TYPE_CHECKING:
+    from serigy.api.inferencia import MotorInferencia, predizer
+
+__all__ = [
+    "Noticia",
+    "NivelOrdinal",
+    "CriteriosAvaliacao",
+    "NoticiaRequest",
+    "InputEco",
+    "ComponentesConfianca",
+    "PesosComponentes",
+    "ProbabilidadesOrdinais",
+    "OutputPredicao",
+    "MetricasInferencia",
+    "PredicaoResponse",
+    "MotorInferencia",
+    "predizer",
+]
+
+
+def __getattr__(name: str) -> Any:
+    if name in ("MotorInferencia", "predizer"):
+        from serigy.api import inferencia as _inf
+
+        return getattr(_inf, name)
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")