Metadata-Version: 2.4
Name: hugpy-oracle
Version: 0.2.2
Summary: Hugpy oracle: creative planning, model selection, screenplay and storyboard generation, DAG runtime, repair, evaluation and ledgers over the video pipeline
Author-email: putkoff <support@hugpy.ai>
License-Expression: LicenseRef-Proprietary
Project-URL: Homepage, https://hugpy.ai
Project-URL: Documentation, https://github.com/hugpy/hugpy/blob/main/py/cinema/hugpy_oracle/README.md
Project-URL: Repository, https://github.com/hugpy/hugpy
Project-URL: Source, https://github.com/hugpy/hugpy/tree/main/py/cinema/hugpy_oracle
Project-URL: Issues, https://github.com/hugpy/hugpy/issues
Project-URL: Changelog, https://github.com/hugpy/hugpy/releases
Project-URL: Architecture, https://github.com/hugpy/hugpy/blob/main/PARTITION.md
Keywords: hugpy,llm,self-hosted,planning,video,orchestration,evaluation
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: hugpy-platform
Requires-Dist: hugpy-control
Requires-Dist: hugpy-engine
Requires-Dist: hugpy-media
Requires-Dist: hugpy-video
Provides-Extra: test
Requires-Dist: pytest>=8; extra == "test"
Dynamic: license-file

# hugpy-oracle

`hugpy_oracle` — extracted from `abstract_hugpy_dev` as part of the Hugpy
partition. Ownership and allowed dependencies are declared in
`py/partition.toml`; see `PARTITION.md` at the workspace root.

Allowed Python dependencies inside the ecosystem: hugpy_platform, hugpy_control, hugpy_engine, hugpy_media, hugpy_video.

## Seams

- `hugpy_oracle.providers` — Protocols for what the oracle needs from packages
  it must not import, each with a safe default: `DossierSource` (curation's
  dossier store), `DoctrineSource` (fleet doctrine), `TaskCapabilityGate`
  (fleet's capability-honesty rule), `LoadStateSource` (model residency per
  worker). The composition root installs implementations with `set_*()`.
  Worker rosters and the blocklist come from `hugpy_engine.placement`.
- `hugpy_oracle.relay.hooks` / `hugpy_oracle.install_hooks()` — the oracle's
  side of `hugpy_video.hooks`: the `PromptCoordinator` implementation and the
  `(oracle, performance)` bus runner.
- `hugpy_oracle.config` — every state root (reliability ledger, routing
  matrix, benchmark battery, run journals) resolved in one place; per-store env
  vars (`ORACLE_LEDGER_PATH`, `ORACLE_BENCHMARK_ROOT`, ...) win, then
  `HUGPY_ORACLE_HOME` / `HUGPY_ORACLE_RUNS_ROOT`, then `hugpy_platform.app_dirs`.

## Command line

`hugpy-oracle steward [--apply] [--api URL|--local] [--ledger PATH]` runs one
steward pass (remote against a running central when `HUGPY_API` is set,
otherwise in-process over the shared ledger); `deploy/hugpy-steward.{service,timer}`
schedule it. `hugpy-oracle install-hooks` reports what the video hooks wired.
