Python Package API Reference¶
This section documents the public Python APIs for the three PyPI packages that ship from this repository. Pages here are auto-generated from docstrings and type signatures via mkdocstrings.
| Package | Install | Purpose |
|---|---|---|
soc-pipeline | pip install soc-pipeline | Clauset-grade power-law fit + bootstrap CI + Vuong LR test + null controls |
cross-judge | pip install cross-judge | Multi-vendor LLM ensemble-judge with majority / unanimous / Krippendorff metrics |
guarded-llm | pip install guarded-llm | Strict JSON LLM calls with schema validation, budget guard, retry policy |
For the hosted HTTP API (POST /api/ask etc.), see API reference.
Quick links¶
- Top-level entry points:
validate,Ensemble.judge,GuardedLLM.call - Verdict types:
Verdict(soc),EnsembleVerdict(cross-judge) - Budget / retry:
Budget,RetryPolicy
Conventions¶
- All public names are listed in each package's
__all__. - Type hints follow PEP 604 (
X | None). - Docstrings follow Google style.
- Examples in docstrings are doctest-style and runnable.