Skip to main content

cuvis-ai-schemas

Lightweight schema definitions for the cuvis-ai ecosystem.

PyPI version CI Status codecov License Python

Overview

cuvis-ai-schemas is a centralized, dependency-light package of schema definitions used across the cuvis-ai ecosystem. It enables type-safe communication between services without heavy runtime requirements.

Key points:

  • Minimal deps (pydantic + pyyaml)
  • Full Pydantic validation
  • Optional extras for proto, torch, numpy, lightning, testing

Installation

uv add cuvis-ai-schemas
uv add "cuvis-ai-schemas[proto]"
uv add "cuvis-ai-schemas[full]"

Extras:

  • proto: gRPC and protobuf support
  • torch: PyTorch dtype handling (validation only)
  • numpy: NumPy array support
  • lightning: PyTorch Lightning training configs
  • testing: Hypothesis strategies + round-trip assertions (cuvis_ai_schemas.testing)
  • full: All features
  • dev: Development dependencies

Usage

from cuvis_ai_schemas.pipeline import PipelineConfig, NodeConfig

pipeline = PipelineConfig(
    nodes=[NodeConfig(name="node_1", class_name="my_pkg.DataLoader", hparams={"batch_size": 32})],
    connections=[],
)

pipeline_json = pipeline.to_json()
pipeline = PipelineConfig.from_json(pipeline_json)

Development

uv sync --all-extras --dev
uv run pytest tests/ -v
uv run ruff check cuvis_ai_schemas/ tests/
uv run ruff format cuvis_ai_schemas/ tests/
uv run mypy cuvis_ai_schemas/

Contributing

Contributions are welcome. Please:

  1. Ensure tests pass
  2. Run ruff format and ruff check
  3. Keep type hints and update docs as needed

License

Licensed under the Apache License 2.0. See LICENSE for details.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cuvis_ai_schemas-0.9.0.tar.gz (252.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cuvis_ai_schemas-0.9.0-py3-none-any.whl (76.7 kB view details)

Uploaded Python 3

File details

Details for the file cuvis_ai_schemas-0.9.0.tar.gz.

File metadata

  • Download URL: cuvis_ai_schemas-0.9.0.tar.gz
  • Upload date:
  • Size: 252.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for cuvis_ai_schemas-0.9.0.tar.gz
Algorithm Hash digest
SHA256 c03f9fd0f2cddba0309a7336434417f8846db309f29c3cc67ceb8fedd542f6ab
MD5 627b2d979c42183d5f93d390af5689ff
BLAKE2b-256 e9a333a5615e4ca40b8c227dbfb34c7362bccf58723f1007c744535339eccbf3

See more details on using hashes here.

Provenance

The following attestation bundles were made for cuvis_ai_schemas-0.9.0.tar.gz:

Publisher: pypi-release.yml on cubert-hyperspectral/cuvis-ai-schemas

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file cuvis_ai_schemas-0.9.0-py3-none-any.whl.

File metadata

File hashes

Hashes for cuvis_ai_schemas-0.9.0-py3-none-any.whl
Algorithm Hash digest
SHA256 17fc61b890d49e67a283ad4db53f120052d562019b9117ac85d5e7e262ba61d7
MD5 6320d5f7aeb8e558c1ef16befed5b688
BLAKE2b-256 73d3e6a169b41441a48d3cd59638d0f183d34d3ebf78e6b66c7e690c66b8c9cc

See more details on using hashes here.

Provenance

The following attestation bundles were made for cuvis_ai_schemas-0.9.0-py3-none-any.whl:

Publisher: pypi-release.yml on cubert-hyperspectral/cuvis-ai-schemas

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page