Ayase
Modular media quality metrics for video, image, and audio datasets.
Work in progress - APIs and module interfaces may change before 1.0.
What It Does
Ayase runs quality assessment modules over a dataset and writes structured per-sample metrics. 334 modules produce 398 metrics across 21 categories (NR-IQA, FR-IQA, NR-VQA, temporal, motion, audio, face, safety, aesthetics, text-video alignment, and more). Modules are independent - pick only what you need.
Full metric catalog: METRICS.md. Pretrained model catalog: MODELS.md.
Install
pip install ayase
Ayase is distributed as a single install. Runtime dependencies are managed by the project itself, and model weights are downloaded and cached on first use.
CLI
ayase scan ./dataset # default balanced pipeline
ayase scan ./dataset --deep # run every discovered module
ayase scan ./dataset --modules metadata,basic_quality # selected modules
ayase modules list # show all 334 modules
ayase modules check # import/dependency readiness
ayase filter ./dataset --min-score 70 --output ./good # filter by quality
ayase stats ./dataset # dataset statistics for images/video
ayase tui # terminal UI
Python API
from ayase import AyasePipeline
pipeline = AyasePipeline(modules=["basic", "metadata", "motion"])
results = pipeline.run("./my_dataset")
for path, sample in results.items():
qm = sample.quality_metrics
if qm:
print(f"{sample.path.name}: technical={qm.technical_score} blur={qm.blur_score}")
pipeline.export("report.json") # also: report.csv, report.html
Configuration
ayase.toml in project root:
[general]
parallel_jobs = 8 # concurrency hint passed to capable modules/backends
[pipeline]
modules = ["metadata", "basic_quality", "motion"]
[output]
default_format = "json"
artifacts_dir = "reports"
Custom Modules
from ayase.models import QualityMetrics, Sample, ValidationIssue, ValidationSeverity
from ayase.pipeline import PipelineModule
import cv2
class BlurCheck(PipelineModule):
name = "blur_check"
description = "Flag blurry frames via Laplacian variance"
default_config = {"threshold": 100.0}
def process(self, sample: Sample) -> Sample:
img = cv2.imread(str(sample.path), cv2.IMREAD_GRAYSCALE)
if img is None:
return sample
score = float(cv2.Laplacian(img, cv2.CV_64F).var())
if sample.quality_metrics is None:
sample.quality_metrics = QualityMetrics()
sample.quality_metrics.blur_score = score
if score < self.config.get("threshold", 100.0):
sample.validation_issues.append(
ValidationIssue(
severity=ValidationSeverity.WARNING,
message=f"Blurry ({score:.0f})",
)
)
return sample
Modules auto-register via __init_subclass__. Config is available as self.config.
Development
git clone <repo-url> && cd ayase
pip install -e ".[dev]"
pytest # 8000+ tests, ~4 min
pytest tests/ --full # with ML model loading
License
MIT. Model weights downloaded at runtime carry their own licenses - see MODELS.md.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ayase-0.1.61.tar.gz.
File metadata
- Download URL: ayase-0.1.61.tar.gz
- Upload date:
- Size: 9.0 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.10.11
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fad6f150dfb856a0069c1d94da00df46873f04db19e8dc111913432b906a10d3
|
|
| MD5 |
f5877579d26a82cab162a9279a4bde0d
|
|
| BLAKE2b-256 |
e3b59b52116767dcc2172bf69433c79b1a95e8e669db70db709fdabdebc31341
|
File details
Details for the file ayase-0.1.61-py3-none-any.whl.
File metadata
- Download URL: ayase-0.1.61-py3-none-any.whl
- Upload date:
- Size: 9.7 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.10.11
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8ba0e85aa6eb3b6fcc949aab47fbaf9f326bce2c8b3ed241405932ba66aaeddc
|
|
| MD5 |
6ecdc599168b70f00d7fd28351573bec
|
|
| BLAKE2b-256 |
533daf1b0dcb022bc40ba4e035abc890d88ad1a88bf1bf9cc4cca8ab05aa1c29
|
