Operon

deploy status codecov

A Python-based, file-based database designed for large-scale genomic data, used for archiving, quality control, analysis, and deterministic automation.

点此阅读中文自述文件。

Features

  • File-based: A single SQLite file (operon.sqlite) serves as the sole writable source of truth; CSV/XLSX are used for controlled imports, TSV reports are used for read-only exchange, and field contracts are defined by a YAML schema
  • NCBI Datasets Adapter: Offline-first import of JSON/JSONL, ZIP, or unpacked directories; also supports online download of genome packages with automatic archiving
  • Frozen NCBI Taxonomy Coverage: Versioned YAML profiles are compiled into family/genus denominators with SHA-256 hashes, allowing separate auditing of current metadata and immutable releases, and generating a list of missing samples
  • Streaming Parsing and Built-in QC: FASTA, FASTQ, GFF3, and protein FASTA files are not loaded entirely into memory; metrics are written to a long table, and decisions are delegated to the versioned YAML profile rule engine; value_by allows thresholds to be selected based on classification metrics such as BUSCO auto-lineage
  • Encapsulated External Analysis: config/tools.yaml specifies the launch methods for BLAST/HMMER/BUSCO, artifact types, constrained runtime parameters, version detection, caching, and result write-back; analyze executes the entire library or specified categories with a single command
  • Local Control, Remote Storage and Computing: SQLite, configuration, and provenance are retained locally, while raw large files can reside on a verified SFTP mirror; the execution backend supports local, Slurm, SSH, and remote Slurm environments
  • Universal Executor: The structured command executor and import-qc can integrate with any external tools, such as QUAST, FastQC, fastp, and CheckM2
  • Immutable release: Dataset snapshots with manifests, checksums, exclusion reports, and provenance; verifiable via sha256sum -c

Dependencies

  • Python 3.10+
  • Runtime dependencies: PyYAML, requests, aiohttp, Biopython, Paramiko, Textual, and questionary; the built-in QC acceleration extension is compiled when the package is built
  • Optional extras: test (pytest and Cython), build (cx_Freeze, Cython, and documentation tooling), docs (documentation tooling), and dev (all development/build dependencies)

Install

# Install the published package
python3 -m venv .venv
source .venv/bin/activate
python -m pip install OperonDBS

For an editable checkout, run from the repository root:

python -m pip install -e '.[dev]'

PyPI installation does not use cx_Freeze. To build the separately distributed standalone application instead:

python -m pip install -e '.[build]'
python tools/build.py

Documentation

The complete documentation is maintained in English and Chinese. To build the Sphinx site locally:

python -m pip install -e '.[docs]'
sphinx-build -W --keep-going -b html docs docs/_build/html

Read the Docs uses the repository's .readthedocs.yaml configuration and publishes a language-selection page with mirrored /en/ and /zh/ documentation trees.

Project links

Data verified by PyPI on Sep 4, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.8.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for hyli360 from gravatar.com hyli360

Credits

Author: hyli360

GitHub Statistics

Data verified by PyPI on Sep 4, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

AGPL-3.0-or-later
View SPDX License List

Requires

Python >=3.10

Provides Extra

test build docs dev

Classifiers

Report project as malware

Download files

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

Source Distribution

operondbs-0.6.2.tar.gz (631.6 kB view details)

Uploaded Source

Built Distributions

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

operondbs-0.6.2-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (1.4 MB view details)

Uploaded CPython 3.14manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

operondbs-0.6.2-cp314-cp314-macosx_11_0_arm64.whl (425.3 kB view details)

Uploaded CPython 3.14macOS 11.0+ ARM64

operondbs-0.6.2-cp314-cp314-macosx_10_15_x86_64.whl (428.7 kB view details)

Uploaded CPython 3.14macOS 10.15+ x86-64

operondbs-0.6.2-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (1.4 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

operondbs-0.6.2-cp313-cp313-macosx_11_0_arm64.whl (422.4 kB view details)

Uploaded CPython 3.13macOS 11.0+ ARM64

operondbs-0.6.2-cp313-cp313-macosx_10_13_x86_64.whl (427.9 kB view details)

Uploaded CPython 3.13macOS 10.13+ x86-64

operondbs-0.6.2-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (1.4 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

operondbs-0.6.2-cp312-cp312-macosx_11_0_arm64.whl (423.3 kB view details)

Uploaded CPython 3.12macOS 11.0+ ARM64

operondbs-0.6.2-cp312-cp312-macosx_10_13_x86_64.whl (428.6 kB view details)

Uploaded CPython 3.12macOS 10.13+ x86-64

operondbs-0.6.2-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (1.5 MB view details)

Uploaded CPython 3.11manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

operondbs-0.6.2-cp311-cp311-macosx_11_0_arm64.whl (422.5 kB view details)

Uploaded CPython 3.11macOS 11.0+ ARM64

operondbs-0.6.2-cp311-cp311-macosx_10_9_x86_64.whl (429.9 kB view details)

Uploaded CPython 3.11macOS 10.9+ x86-64

operondbs-0.6.2-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (1.4 MB view details)

Uploaded CPython 3.10manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

operondbs-0.6.2-cp310-cp310-macosx_11_0_arm64.whl (423.1 kB view details)

Uploaded CPython 3.10macOS 11.0+ ARM64

operondbs-0.6.2-cp310-cp310-macosx_10_9_x86_64.whl (430.3 kB view details)

Uploaded CPython 3.10macOS 10.9+ x86-64

File details

Details for the file operondbs-0.6.2.tar.gz.

File metadata

  • Download URL: operondbs-0.6.2.tar.gz
  • Upload date:
  • Size: 631.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for operondbs-0.6.2.tar.gz
Algorithm Hash digest
SHA256 08bc9f5c98520026dcdca1a8e2da875b80124d45df21ee1c473c56e321c9e2df
MD5 3016bbaca5c213f4b44cc365517044d5
BLAKE2b-256 c14314608633c3e3f5007adaefc4786fcccf1b3823b7a6a3712f49d6f2e4df64

See more details on using hashes here.

Provenance

The following attestation bundles were made for operondbs-0.6.2.tar.gz:

Publisher: publish.yml on HYLi360/Operon

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

File details

Details for the file operondbs-0.6.2-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for operondbs-0.6.2-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 7e460f5f62797abe7120514aaf60175a87013588c6ef592b7a8b7be2d1c77731
MD5 c2798666ce2f375bbc263043d3d1fd13
BLAKE2b-256 ea6d8a576b06748d8f146859930b321766f3e90e4457fcd10f1e916d44b1e634

See more details on using hashes here.

Provenance

The following attestation bundles were made for operondbs-0.6.2-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl:

Publisher: publish.yml on HYLi360/Operon

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

File details

Details for the file operondbs-0.6.2-cp314-cp314-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for operondbs-0.6.2-cp314-cp314-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 11fe975e3c5a063eaff3f0fd6025c264937042a19ddfd930dacc8d15f9204c96
MD5 591bc0b7ddc24a07b109c0cc9a0e8a93
BLAKE2b-256 6121ab124ec0d571007f734eb1cd32fd5c210f9f53541f3a0d8536c4df8a2365

See more details on using hashes here.

Provenance

The following attestation bundles were made for operondbs-0.6.2-cp314-cp314-macosx_11_0_arm64.whl:

Publisher: publish.yml on HYLi360/Operon

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

File details

Details for the file operondbs-0.6.2-cp314-cp314-macosx_10_15_x86_64.whl.

File metadata

File hashes

Hashes for operondbs-0.6.2-cp314-cp314-macosx_10_15_x86_64.whl
Algorithm Hash digest
SHA256 11f24d713fd73b994186cdc19ad7cff940f1bee4b1089ddb34ff45d7c50ff32b
MD5 56c2efeb0297862708988ffb6847670f
BLAKE2b-256 1cd5b1121fe7d1728a102d6a4855a1774877ed577947fe1046f4673bcb4149da

See more details on using hashes here.

Provenance

The following attestation bundles were made for operondbs-0.6.2-cp314-cp314-macosx_10_15_x86_64.whl:

Publisher: publish.yml on HYLi360/Operon

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

File details

Details for the file operondbs-0.6.2-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for operondbs-0.6.2-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 24b12488953cd61060c8a8948347b7296d00fde39bc3e988af3e16048d5c274d
MD5 412b29d559a6d45f59413a820cc8f023
BLAKE2b-256 db761f417ba544fbefcf80d532e2903f4540d3a83acb9c01861e168cd2b5d25e

See more details on using hashes here.

Provenance

The following attestation bundles were made for operondbs-0.6.2-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl:

Publisher: publish.yml on HYLi360/Operon

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

File details

Details for the file operondbs-0.6.2-cp313-cp313-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for operondbs-0.6.2-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 a53d6abab1c334bbe0bb46acbbea9e6f16b4c73319fdcebda115e8cc679d15aa
MD5 fee19619f5ef703979b589f42adead2c
BLAKE2b-256 c8a337261cd8710b54102de468e91f48d6939e6ce4417ba766fc67f7f10fa74e

See more details on using hashes here.

Provenance

The following attestation bundles were made for operondbs-0.6.2-cp313-cp313-macosx_11_0_arm64.whl:

Publisher: publish.yml on HYLi360/Operon

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

File details

Details for the file operondbs-0.6.2-cp313-cp313-macosx_10_13_x86_64.whl.

File metadata

File hashes

Hashes for operondbs-0.6.2-cp313-cp313-macosx_10_13_x86_64.whl
Algorithm Hash digest
SHA256 544e142b682bb2af60f70989af45950fac6d3a8e793328280eab5c2db5b9e345
MD5 23c6633c32356116203a4ae71f6a6b9d
BLAKE2b-256 6dd5a478c3f23745497a43b695aaee00ce35645f013b343a4a670c69b862d252

See more details on using hashes here.

Provenance

The following attestation bundles were made for operondbs-0.6.2-cp313-cp313-macosx_10_13_x86_64.whl:

Publisher: publish.yml on HYLi360/Operon

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

File details

Details for the file operondbs-0.6.2-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for operondbs-0.6.2-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 f6864800ff6a6caa8a7aca363fae292d3ebbfeb2bef9d72a6698ecf15996f4b8
MD5 9f38042e4c7d1aa6aa10c75a83875ae3
BLAKE2b-256 de3d6615023a73087c96ad50006db657fb65613e5d5b92de65b06190bcbaac96

See more details on using hashes here.

Provenance

The following attestation bundles were made for operondbs-0.6.2-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl:

Publisher: publish.yml on HYLi360/Operon

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

File details

Details for the file operondbs-0.6.2-cp312-cp312-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for operondbs-0.6.2-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 6278d4031196081cc80a36ae5cfc9ef492ff16433900a3f2690afddac1d99dea
MD5 3e3af51aede52c6c4708ef0f96648b87
BLAKE2b-256 a55dc7edf904e9670bfa1a6b63a82bec6247a69c192b3a599af40484bdabf784

See more details on using hashes here.

Provenance

The following attestation bundles were made for operondbs-0.6.2-cp312-cp312-macosx_11_0_arm64.whl:

Publisher: publish.yml on HYLi360/Operon

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

File details

Details for the file operondbs-0.6.2-cp312-cp312-macosx_10_13_x86_64.whl.

File metadata

File hashes

Hashes for operondbs-0.6.2-cp312-cp312-macosx_10_13_x86_64.whl
Algorithm Hash digest
SHA256 a8c1e4fda3fcf4885c0d7ec6d957116555007f7bc71c92d2c7587db9643eb7e5
MD5 437c002c3885dc71cd0fa274f39cb568
BLAKE2b-256 e5f708c12f118f0e593bc79cf0f8fae103b75baf7c0d93c8bacf91ed743fe974

See more details on using hashes here.

Provenance

The following attestation bundles were made for operondbs-0.6.2-cp312-cp312-macosx_10_13_x86_64.whl:

Publisher: publish.yml on HYLi360/Operon

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

File details

Details for the file operondbs-0.6.2-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for operondbs-0.6.2-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 74e1f72b118937f01abc9d45d21e1026208d837b113aaf7d455c4011d66274be
MD5 764c69f5facf2ad40ade9f9be86ff413
BLAKE2b-256 c561699172191b92a29ccd7230220389f7d9119a536fed3ff9192468997a761c

See more details on using hashes here.

Provenance

The following attestation bundles were made for operondbs-0.6.2-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl:

Publisher: publish.yml on HYLi360/Operon

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

File details

Details for the file operondbs-0.6.2-cp311-cp311-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for operondbs-0.6.2-cp311-cp311-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 2eeb61a7dc2d4a8e1827f4ef7f197469cf590ddc388774d97b67a030e939615b
MD5 c16d8b3867baa6f95afff75e3857d797
BLAKE2b-256 89f5628e6e6e32f124f8ee7022ed93c836d0cffc550b56a3c2f869cff113d13b

See more details on using hashes here.

Provenance

The following attestation bundles were made for operondbs-0.6.2-cp311-cp311-macosx_11_0_arm64.whl:

Publisher: publish.yml on HYLi360/Operon

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

File details

Details for the file operondbs-0.6.2-cp311-cp311-macosx_10_9_x86_64.whl.

File metadata

File hashes

Hashes for operondbs-0.6.2-cp311-cp311-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 3ed0a251c66b4b9f783f78116ebc148f10699fd7c8945131aae2e21b1f7163c2
MD5 d299163d542d8cbc21a5995ed7b3e224
BLAKE2b-256 f2ac21720fd39f92d7d2c5f3ab92afa76bd7e6c1f3ef697e5dc3fcef3a9239e4

See more details on using hashes here.

Provenance

The following attestation bundles were made for operondbs-0.6.2-cp311-cp311-macosx_10_9_x86_64.whl:

Publisher: publish.yml on HYLi360/Operon

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

File details

Details for the file operondbs-0.6.2-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for operondbs-0.6.2-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 eecc571dd912bacecbd04b7ef3d472120f4e5764eb68629192eaf745e922b1bd
MD5 93a2876272bd7c54d3ad573334146bef
BLAKE2b-256 dcb925dc1f514d57571ecbc00cca866e496f5902b5915117853f46a96eb8cbfa

See more details on using hashes here.

Provenance

The following attestation bundles were made for operondbs-0.6.2-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl:

Publisher: publish.yml on HYLi360/Operon

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

File details

Details for the file operondbs-0.6.2-cp310-cp310-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for operondbs-0.6.2-cp310-cp310-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 40f1d35fc945b22ce16642b785ff52b6c7d468363db40fc6b26d47caf1d3450f
MD5 0e0a4622874ae02f83642e9ac79cb8ae
BLAKE2b-256 1b6147bf27ea3cace2202acaa0d0a09106c256212c836a36a0dc777af3c917f4

See more details on using hashes here.

Provenance

The following attestation bundles were made for operondbs-0.6.2-cp310-cp310-macosx_11_0_arm64.whl:

Publisher: publish.yml on HYLi360/Operon

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

File details

Details for the file operondbs-0.6.2-cp310-cp310-macosx_10_9_x86_64.whl.

File metadata

File hashes

Hashes for operondbs-0.6.2-cp310-cp310-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 6a47f761f6b35a9e701f3394facf41faba6ad3a697bc3c9f2c3cff4f6d5cd05b
MD5 d3aae9b37c5160cb7480a9a365359093
BLAKE2b-256 05fea62ccba7bbcb99dfcd3e856536ab1d258fde3804c4c56ef494257adfa085

See more details on using hashes here.

Provenance

The following attestation bundles were made for operondbs-0.6.2-cp310-cp310-macosx_10_9_x86_64.whl:

Publisher: publish.yml on HYLi360/Operon

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

Release history Release notifications | RSS feed

0.8.0

16 files

0.7.2

16 files

0.7.0

16 files

This release

0.6.2 This release

16 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page