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 5, 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 5, 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.7.0.tar.gz (673.0 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.7.0-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.7.0-cp314-cp314-macosx_11_0_arm64.whl (432.4 kB view details)

Uploaded CPython 3.14macOS 11.0+ ARM64

operondbs-0.7.0-cp314-cp314-macosx_10_15_x86_64.whl (435.8 kB view details)

Uploaded CPython 3.14macOS 10.15+ x86-64

operondbs-0.7.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (1.5 MB view details)

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

operondbs-0.7.0-cp313-cp313-macosx_11_0_arm64.whl (429.5 kB view details)

Uploaded CPython 3.13macOS 11.0+ ARM64

operondbs-0.7.0-cp313-cp313-macosx_10_13_x86_64.whl (435.0 kB view details)

Uploaded CPython 3.13macOS 10.13+ x86-64

operondbs-0.7.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (1.5 MB view details)

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

operondbs-0.7.0-cp312-cp312-macosx_11_0_arm64.whl (430.4 kB view details)

Uploaded CPython 3.12macOS 11.0+ ARM64

operondbs-0.7.0-cp312-cp312-macosx_10_13_x86_64.whl (435.7 kB view details)

Uploaded CPython 3.12macOS 10.13+ x86-64

operondbs-0.7.0-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.7.0-cp311-cp311-macosx_11_0_arm64.whl (429.6 kB view details)

Uploaded CPython 3.11macOS 11.0+ ARM64

operondbs-0.7.0-cp311-cp311-macosx_10_9_x86_64.whl (437.0 kB view details)

Uploaded CPython 3.11macOS 10.9+ x86-64

operondbs-0.7.0-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.7.0-cp310-cp310-macosx_11_0_arm64.whl (430.2 kB view details)

Uploaded CPython 3.10macOS 11.0+ ARM64

operondbs-0.7.0-cp310-cp310-macosx_10_9_x86_64.whl (437.4 kB view details)

Uploaded CPython 3.10macOS 10.9+ x86-64

File details

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

File metadata

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

File hashes

Hashes for operondbs-0.7.0.tar.gz
Algorithm Hash digest
SHA256 75ba741d75e8ff162c25231ea11724e4e17d6d9ff4e456cf1912e11ce78f9786
MD5 51b5aa7010e9cb88f8a97cea3a118fcb
BLAKE2b-256 d97800b0e14106ea3c8fe87c9e7acbc4fb2710d309cc74a5f3176c2ca823f6f0

See more details on using hashes here.

Provenance

The following attestation bundles were made for operondbs-0.7.0.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.7.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for operondbs-0.7.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 4b40df0e4f293d7b42ecc26b70a6ec4161336b5fa5fcd242e8ba61e305dd9313
MD5 44c841e0982e90623a3d812631355347
BLAKE2b-256 2304124dcc28931c4ad9ce7f1e6fcbbb5415b88f1d346e9437907ee89354b8dc

See more details on using hashes here.

Provenance

The following attestation bundles were made for operondbs-0.7.0-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.7.0-cp314-cp314-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for operondbs-0.7.0-cp314-cp314-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 50b4c480e6d090a0c2ae5cbb15d3537eb5a507600063b6cae70da42c91c23053
MD5 4b8929fa5e4829c35e4d09f40984bd49
BLAKE2b-256 df27bc1935419e403485fbf62cc7ce610e1a30613714657cbd0406a6e865f2e0

See more details on using hashes here.

Provenance

The following attestation bundles were made for operondbs-0.7.0-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.7.0-cp314-cp314-macosx_10_15_x86_64.whl.

File metadata

File hashes

Hashes for operondbs-0.7.0-cp314-cp314-macosx_10_15_x86_64.whl
Algorithm Hash digest
SHA256 10e8fa537385e419884b8ba17fc0c6295c3366430f37a68ca47008c50933fdd5
MD5 00334f419f9b6ebebef0f030d35f4cb0
BLAKE2b-256 7e7b90336d2bf2a256769303c59d8f722ff13522b3379553d921e12e081d83ac

See more details on using hashes here.

Provenance

The following attestation bundles were made for operondbs-0.7.0-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.7.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for operondbs-0.7.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 41870d14b3b4eede0b41a36ff99d85cca9f1745573131b0412bffd70b9ce3ed4
MD5 647862288f7d291b58922768a8a5f9ab
BLAKE2b-256 1cbb3c4cd08f6d9073788ebe0bacc956530ad463a014605cba115051add35712

See more details on using hashes here.

Provenance

The following attestation bundles were made for operondbs-0.7.0-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.7.0-cp313-cp313-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for operondbs-0.7.0-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 68a1fd015493ee6ba28d48df7f1fa1b6217980afa613e791123b86242a4780b5
MD5 1a333b0a0469e2e71a23e123780fc55d
BLAKE2b-256 f1bf1b67ef18d0279e68dca3c3b2ec1465167efe28c63cbe7f5b7a7d11e9e1dc

See more details on using hashes here.

Provenance

The following attestation bundles were made for operondbs-0.7.0-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.7.0-cp313-cp313-macosx_10_13_x86_64.whl.

File metadata

File hashes

Hashes for operondbs-0.7.0-cp313-cp313-macosx_10_13_x86_64.whl
Algorithm Hash digest
SHA256 854a7579424d3712aa6ec96482e2565c7f181dae0e53bad7a464dbe502be0866
MD5 8fe3fefca9db990a6a90dd10ba6dbedd
BLAKE2b-256 12cac663adfb04f34d818db4612e262f8c979319bcb6ee8ddfb73fb4e609d3d5

See more details on using hashes here.

Provenance

The following attestation bundles were made for operondbs-0.7.0-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.7.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for operondbs-0.7.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 a829fda5954da45f91bdbc974ee8d2803a0b4a852b9c6dc9370a10bd0bcf3097
MD5 5d3af0b3b4000121d548d4c21818b387
BLAKE2b-256 e71fd11cfb82e297fda53f78c657596c007d5f812f2653514aa50ffe022ce644

See more details on using hashes here.

Provenance

The following attestation bundles were made for operondbs-0.7.0-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.7.0-cp312-cp312-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for operondbs-0.7.0-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 b3e103ea1cfbc0f66d75ae1d1e684a9f02a40f439fa4853742411fc0e3655d98
MD5 31049aa64d03758c8fd1943b2273c070
BLAKE2b-256 1fd391f7d4d7e1f48067abcaa07cccb951ece2b56ff1c3ee6330e87f8f64a301

See more details on using hashes here.

Provenance

The following attestation bundles were made for operondbs-0.7.0-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.7.0-cp312-cp312-macosx_10_13_x86_64.whl.

File metadata

File hashes

Hashes for operondbs-0.7.0-cp312-cp312-macosx_10_13_x86_64.whl
Algorithm Hash digest
SHA256 f437cfebf854e101b177f4ebe3d60596a3ecdc03ead634ddfc043e5ef5c48b56
MD5 83e7d34a56d1da60340511b323b2b73d
BLAKE2b-256 9f7480eb64d4ca1e5697ae7490bdd2c07fb7b501bf997b7e3225a340269bf674

See more details on using hashes here.

Provenance

The following attestation bundles were made for operondbs-0.7.0-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.7.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for operondbs-0.7.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 5cd52ed09e2a09dc027aeb4ddfe15bfd70bfe24fefccb44f5f0ee63a1b838597
MD5 72f79b9e6825dcb2a1907f05b0ead6f3
BLAKE2b-256 c8b6a385392eeb66a8771cf6841a54349293ba2db84d56b837bef3aa2ea18bb0

See more details on using hashes here.

Provenance

The following attestation bundles were made for operondbs-0.7.0-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.7.0-cp311-cp311-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for operondbs-0.7.0-cp311-cp311-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 75c79d958040c0cef317e45241ddc2a1ed2209554b197f0bc96c5ddac92177b1
MD5 5969057cf0260c1e7cba1a0c9281f706
BLAKE2b-256 8e95f4022455453f13492ea5fe7789498b1fc2a088e6342c0b426143b594815d

See more details on using hashes here.

Provenance

The following attestation bundles were made for operondbs-0.7.0-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.7.0-cp311-cp311-macosx_10_9_x86_64.whl.

File metadata

File hashes

Hashes for operondbs-0.7.0-cp311-cp311-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 fb9d9c1e9f106518a0370cde50068e1b28e4953953110342d4e670f59f00b57b
MD5 f80896eb55e4b5d880eb8697649b29a8
BLAKE2b-256 9892e4425511d9be34c332ce99b1950ec150df93388d225f55e32ce7e5ec0764

See more details on using hashes here.

Provenance

The following attestation bundles were made for operondbs-0.7.0-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.7.0-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for operondbs-0.7.0-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 e1daaf631962570650c31780b4c50ef5b3f777b6c161c81e31daafe35262ec4f
MD5 3cde145037e62c42a2f13c54016c9f38
BLAKE2b-256 66db62e642f9d494dea23c0c6d79afe5ae132d167fe2138137f7b3330cd937cd

See more details on using hashes here.

Provenance

The following attestation bundles were made for operondbs-0.7.0-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.7.0-cp310-cp310-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for operondbs-0.7.0-cp310-cp310-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 ac03922c6115f1bf0c7bf8fa9e36cbafa51edc33a21bf40ef6d1bad686b8a5db
MD5 fe0e85e993503f8165b18a552fe5f393
BLAKE2b-256 6c3a71444d7f9a4fa10bb319398a8056b8eaaaa4b808e522c1fd4648c415a200

See more details on using hashes here.

Provenance

The following attestation bundles were made for operondbs-0.7.0-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.7.0-cp310-cp310-macosx_10_9_x86_64.whl.

File metadata

File hashes

Hashes for operondbs-0.7.0-cp310-cp310-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 e3b9aa7202e6520ad98cb1cca3170e221ed02d3b487fc9bcf8c063678f9e99e1
MD5 00fe46291ac9d66f775e8fdfdf5eb422
BLAKE2b-256 c8112b2eba98a405d98ce106f135d8b12486daef698260ae5e31ea72ab30fd8c

See more details on using hashes here.

Provenance

The following attestation bundles were made for operondbs-0.7.0-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

This release

0.7.0 This release

16 files

0.6.2

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