yolozu 1.0.3

Interface-contract-first evaluation toolkit for mitigating catastrophic forgetting and domain shift via reproducible workflows.

YOLOZU (萬)

Japanese: Readme_jp.md

YOLOZU at a glance

• Framework-agnostic evaluation toolkit for vision models: designed for reproducible continual learning and test-time adaptation under domain shift.
• Training-capable workflows for mitigating catastrophic forgetting: supports training and evaluation workflows based on self-distillation, replay, and parameter-efficient updates (PEFT). These approaches reduce forgetting and make it measurable and comparable across runs, though complete elimination is not guaranteed.
• Support for inference-time adaptation (TTT): allows model parameters to be adjusted during inference, enabling continual adaptation to domain shift in deployment.
• Predictions as the stable interface contract: treats predictions---not models---as the primary contract, making training, continual learning, and inference-time adaptation comparable, restartable, and CI-friendly across frameworks and runtimes.
• Multi-task evaluation support: covers object detection, segmentation, keypoint estimation, monocular depth estimation, and 6DoF pose estimation. Training implementations remain configurable and decoupled, rather than fixed to a specific framework.
• Production-ready deployment path: supports ONNX export and execution across PyTorch, ONNX Runtime, and TensorRT, with reference inference templates in C++ and Rust.
• Interface-contract-first, AI-first workflow: every experiment emits versioned artifacts that can be automatically compared and regression-tested in CI.

Quickstart (run this first)

bash scripts/smoke.sh

Output artifact: reports/smoke_coco_eval_dry_run.json.

Docs index (start here): docs/README.md.

AI-friendly tool registry (source of truth): tools/manifest.json.

Tool list + args examples: docs/tools_index.md.

Learning features (training / continual learning / TTT / distillation): docs/learning_features.md.

Start here (choose 1 of 4 entry points)

• A: Evaluate from precomputed predictions (no inference deps) — predictions.json → validate → eval.
• B: Train → Export → Eval (RT-DETR scaffold + run interface contract / Run Contract) — run artifacts → ONNX → parity/eval.
• C: Interface contracts (predictions / adapter / TTT protocol) — schemas + adapter interface contract boundary + safe adaptation protocol.
• D: Bench/Parity (TensorRT / latency benchmark) — parity checks + pinned-protocol benchmarks.

All four entry points are documented (with copy-paste commands) in docs/README.md.

CLI note:

• yolozu ... is the pip/package CLI.
• python3 tools/yolozu.py ... is the repo wrapper CLI.
• For equivalent commands, swap only the executable (yolozu ↔ python3 tools/yolozu.py).

Key points

• Bring-your-own inference → stable predictions.json interface contract.
• Validators catch schema drift early.
• Protocol-pinned export_settings makes comparisons reproducible.
• Parity/bench quantify backend drift and performance.
• Tooling stays CPU-friendly by default (GPU optional).
• Apache-2.0-only ops policy is enforced in repo tooling.

Why YOLOZU?

YOLOZU standardizes evaluation around a predictions-first interface contract: run inference anywhere, export predictions.json (+ export_settings), then validate and evaluate with fixed protocols for reproducible comparisons.

Details: docs/yolozu_spec.md.

Install (pip users)

python3 -m pip install yolozu
yolozu --help
yolozu doctor --output -

Optional (CPU) demos:

python3 -m pip install -U 'yolozu[demo]'
yolozu demo
yolozu demo instance-seg
yolozu demo keypoints
yolozu demo depth
yolozu demo train
yolozu demo continual --compare --markdown

Optional extras and CPU demos: docs/install.md.

Source checkout (repo users)

python3 -m pip install -r requirements-test.txt
python3 -m pip install -e .
python3 tools/yolozu.py --help
python3 -m unittest -q

If you want the optional demo dependencies in a source checkout:

python3 -m pip install -e '.[demo]'

Manual (PDF)

Printable manual source: manual/.

Support / legal

• Contact: [e-mail]
• © 2026 ToppyMicroServices OÜ Full support/legal: docs/support.md.

License

Code in this repository is licensed under the Apache License, Version 2.0. See LICENSE.