Metadata-Version: 2.4
Name: dnakit
Version: 0.1.0.dev0
Summary: Deterministic tools for DNA sequence analysis
Author: DNAKit contributors
License-Expression: MIT
Project-URL: Homepage, https://github.com/mapengsen/DNAKit
Project-URL: Documentation, https://github.com/mapengsen/DNAKit/tree/main/docs
Project-URL: Repository, https://github.com/mapengsen/DNAKit
Project-URL: Issues, https://github.com/mapengsen/DNAKit/issues
Project-URL: Changelog, https://github.com/mapengsen/DNAKit/blob/main/CHANGELOG.md
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Classifier: Typing :: Typed
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: DISCLAIMER.md
License-File: THIRD_PARTY_NOTICES.md
Requires-Dist: PyYAML>=6.0
Requires-Dist: rich>=13.7
Requires-Dist: tomli>=2.0; python_version < "3.11"
Requires-Dist: typer>=0.12
Provides-Extra: dev
Requires-Dist: build>=1.2; extra == "dev"
Requires-Dist: hypothesis>=6.100; extra == "dev"
Requires-Dist: mypy>=1.11; extra == "dev"
Requires-Dist: numpy<3,>=1.26; extra == "dev"
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-cov>=5.0; extra == "dev"
Requires-Dist: ruff>=0.8; extra == "dev"
Requires-Dist: twine>=5.0; extra == "dev"
Requires-Dist: types-PyYAML>=6.0; extra == "dev"
Provides-Extra: docs
Requires-Dist: mkdocs<2,>=1.6; extra == "docs"
Requires-Dist: mkdocs-material<10,>=9.5; extra == "docs"
Requires-Dist: mkdocstrings[python]<1,>=0.27; extra == "docs"
Requires-Dist: nbmake<2,>=1.5; extra == "docs"
Provides-Extra: viz
Requires-Dist: CairoSVG<3,>=2.7; extra == "viz"
Requires-Dist: Pillow<13,>=10; extra == "viz"
Provides-Extra: io
Requires-Dist: pyarrow<26,>=19; extra == "io"
Provides-Extra: validation
Requires-Dist: biopython<2,>=1.85; extra == "validation"
Provides-Extra: neural
Requires-Dist: huggingface-hub<2,>=0.28; extra == "neural"
Requires-Dist: numpy<3,>=1.26; extra == "neural"
Requires-Dist: scikit-learn<2,>=1.5; extra == "neural"
Requires-Dist: torch<3,>=2.5; extra == "neural"
Requires-Dist: transformers<5,>=4.49; extra == "neural"
Provides-Extra: neural-caduceus
Requires-Dist: mamba-ssm<3,>=2.2; extra == "neural-caduceus"
Provides-Extra: neural-enformer
Requires-Dist: enformer-pytorch<1,>=0.8.11; extra == "neural-enformer"
Provides-Extra: neural-evo2
Requires-Dist: evo2<0.6,>=0.5.3; extra == "neural-evo2"
Dynamic: license-file

<p align="center">
  <img alt="DNAKit logo" src="https://raw.githubusercontent.com/mapengsen/DNAKit/main/docs/assets/images/DNAKit-icon.png" width="40%">
</p>

<p align="center">
  <a href="https://pypi.org/project/dnakit/">
    <img src="https://img.shields.io/pypi/v/dnakit?include_prereleases&amp;label=PyPI" alt="PyPI version">
  </a>
  <a href="https://github.com/mapengsen/DNAKit/actions/workflows/ci.yml">
    <img src="https://github.com/mapengsen/DNAKit/actions/workflows/ci.yml/badge.svg" alt="CI status">
  </a>
  <a href="https://pypi.org/project/dnakit/">
    <img src="https://img.shields.io/pypi/pyversions/dnakit" alt="Supported Python versions">
  </a>
  <a href="https://github.com/mapengsen/DNAKit/blob/main/LICENSE">
    <img src="https://img.shields.io/github/license/mapengsen/DNAKit" alt="MIT license">
  </a>
</p>

# DNAKit 是什么？

DNAKit 是面向 DNA 序列的可复现 Python 工具包，定位类似“DNA 领域的 RDKit”。它覆盖标准化、文件与注释格式、基础操作、描述符、模式扫描、热力学、指纹、相似度、聚类与数据划分、综合评价、分子生物学模拟和可视化，并可选用 DNA 基础模型提取 rep 后进行 k-means 聚类；不集成启动子活性、表达量、TF 结合强度或 CRISPR 编辑效率等任务型深度学习预测模型。

# 安装与快速入门

安装当前开发预览版：

```bash
pip install dnakit==0.1.0.dev0
```

如果需要参与开发，克隆仓库后通过 Conda 创建完整环境：

```bash
conda env create -f environment-dev.yml
conda activate dnakit-dev
```

随后可以阅读 [Python 快速入门指南](https://github.com/mapengsen/DNAKit/blob/main/docs/quickstart.md)。

更详细的依赖、可选后端和安装说明见 [安装文档](https://github.com/mapengsen/DNAKit/blob/main/docs/installation.md)。

# 文档

完整文档位于 [DNAKit 文档首页](https://github.com/mapengsen/DNAKit/blob/main/docs/index.md) 和仓库的 [`docs`](https://github.com/mapengsen/DNAKit/tree/main/docs) 目录。

所有功能模块可在 [功能树总览](https://github.com/mapengsen/DNAKit/blob/main/docs/api/features/function_tree.md) 中查看，常见问题见 [FAQ](https://github.com/mapengsen/DNAKit/blob/main/docs/faq.md)。

# 支持与社区

如果有问题、意见或建议，可以先查看：

- [常见问题](https://github.com/mapengsen/DNAKit/blob/main/docs/faq.md)
- [贡献指南](https://github.com/mapengsen/DNAKit/blob/main/CONTRIBUTING.md)
- [GitHub Issues](https://github.com/mapengsen/DNAKit/issues)

如果发现缺陷或希望增加功能，请按照 [贡献指南](https://github.com/mapengsen/DNAKit/blob/main/CONTRIBUTING.md) 中的要求记录问题和复现信息。

DNAKit 当前处于开发预览阶段，公开接口在正式版本发布前可能调整。
