yolo-mcp 2.0.0__tar.gz

yolo_mcp-2.0.0/.env.example

@@ -0,0 +1,15 @@
+# 默认数据目录为用户主目录下的 .yolo-mcp，可按需覆盖。
+# DATA_DIR=~/.yolo-mcp
+
+# 默认 SQLite 位于 DATA_DIR/labels.sqlite，可按需指定其他数据库。
+# DATABASE_URL=sqlite:///your/custom/labels.sqlite
+
+# 签名密钥首次启动时自动生成到 DATA_DIR/secret.key，后续启动复用。
+
+# AI 和页面训练复用当前 Python 的 GPU 环境；留空自动选择设备。
+USE_AUTO_LABEL=true
+DEVICE=
+
+# MCP 默认只接受本机地址。远程部署时填写实际域名与来源的 JSON 数组。
+# MCP_ALLOWED_HOSTS=["yolo.example.com"]
+# MCP_ALLOWED_ORIGINS=["https://yolo.example.com"]

yolo_mcp-2.0.0/.flake8

@@ -0,0 +1,7 @@
+[flake8]
+max-line-length = 88
+extend-exclude = .venv, __pycache__, statics
+
+# 隔离测试配置必须先于应用导入设置，避免触及开发数据库。
+per-file-ignores =
+    tests/conftest.py:E402

yolo_mcp-2.0.0/.gitignore

@@ -0,0 +1,45 @@
+# 环境、凭据和本地运行文件。
+.env
+.env.*
+!.env.example
+secret.key
+.venv/
+.venv-*/
+.tmp/
+.cache/
+/data/
+*.sqlite
+*.sqlite-journal
+*.sqlite-wal
+*.sqlite-shm
+*.db
+*.log
+
+# Python 与前端依赖、缓存和构建产物。
+__pycache__/
+*.py[cod]
+*.egg-info/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+node_modules/
+dist/
+build/
+coverage/
+*.tsbuildinfo
+
+# 模型权重和训练输出保存在本地数据目录，不纳入版本控制。
+*.pt
+*.onnx
+*.engine
+
+# 前端静态资源在构建时生成。
+/backend/statics/*
+!/backend/statics/__init__.py
+
+.DS_Store
+Thumbs.db
+
+# 后端运行数据与训练工作目录。
+/backend/data/
+/backend/workspace/

yolo_mcp-2.0.0/LICENSE

@@ -0,0 +1,203 @@
+Copyright 2018-2023 OpenMMLab. All rights reserved.
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2018-2023 OpenMMLab.
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

yolo_mcp-2.0.0/PKG-INFO

@@ -0,0 +1,92 @@
+Metadata-Version: 2.5
+Name: yolo-mcp
+Version: 2.0.0
+Summary: YOLO MCP local image annotation and YOLO training
+Project-URL: repository, https://github.com/killf/LabelS
+Author-email: shenguanlin <shenguanlin@pjlab.org.cn>
+License: Apache-2.0
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: aiofiles>=22.1.0
+Requires-Dist: alembic>=1.9.4
+Requires-Dist: bcrypt==4.3.0
+Requires-Dist: click>=8.0
+Requires-Dist: email-validator>=2.0.0
+Requires-Dist: fastapi>=0.100.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: loguru>=0.6.0
+Requires-Dist: mcp==2.3.0
+Requires-Dist: pillow>=9.3.0
+Requires-Dist: pydantic-settings>=2.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=0.21.0
+Requires-Dist: python-jose[cryptography]>=3.3.0
+Requires-Dist: python-multipart>=0.0.5
+Requires-Dist: pyyaml<7,>=6.0
+Requires-Dist: sqlalchemy>=2.0.0
+Requires-Dist: uvicorn>=0.19.0
+Requires-Dist: websockets>=10.0.0
+Provides-Extra: annotation
+Requires-Dist: einops<1,>=0.8; extra == 'annotation'
+Requires-Dist: huggingface-hub<1,>=0.30; extra == 'annotation'
+Requires-Dist: timm<2,>=1; extra == 'annotation'
+Requires-Dist: torch<3,>=2.9; extra == 'annotation'
+Requires-Dist: torchvision<1,>=0.24; extra == 'annotation'
+Requires-Dist: transformers==4.51.3; extra == 'annotation'
+Provides-Extra: mysql
+Requires-Dist: mysqlclient>=2.1.1; extra == 'mysql'
+Provides-Extra: training
+Requires-Dist: pyyaml<7,>=6.0.3; extra == 'training'
+Requires-Dist: torch<3,>=2.9; extra == 'training'
+Requires-Dist: torchvision<1,>=0.24; extra == 'training'
+Requires-Dist: tzdata>=2025.2; extra == 'training'
+Requires-Dist: ultralytics==8.4.203; extra == 'training'
+Description-Content-Type: text/markdown
+
+# YOLO MCP 后端
+
+本目录是独立 Python 项目，源码包名为 `backend`。业务说明、前端运行和参考项目见[仓库 README](../README.md)。
+
+## Web 服务
+
+从本目录执行：
+
+```bash
+uv sync --python 3.11 --frozen --group test
+cp .env.example .env
+# 按需调整 DATA_DIR、USE_AUTO_LABEL 和 DEVICE；签名密钥首次启动时自动生成。
+uv run --env-file .env uvicorn backend.main:app --host 127.0.0.1 --port 8002
+```
+
+`yolo-mcp` 也是服务 CLI 入口。模块导入和 `--help` 不初始化数据库，实际应用启动时通过 `migrations/versions/001_init_db.py` 初始化空库；默认 SQLite 文件名为 `labels.sqlite`。结构调整后使用新库，旧库不会自动迁移。不提供历史结构升级或 to_mysql。
+
+`DATA_DIR` 默认指向用户主目录的 `.yolo-mcp/`。服务首次启动时在此目录生成 `secret.key`，后续启动读取同一密钥；数据库和项目文件也默认保存在此目录。
+
+空库允许一次网页初始化管理员，完成后由管理员添加其他账号。个人令牌在网页管理，MCP 使用 Streamable HTTP `/mcp` 和 `Authorization: Bearer <个人令牌>`；不提供 OAuth 流程。项目拥有者管理配置和成员，协作者可以标注及训练，系统管理员管理全部项目。详细用法见[用户权限与 MCP 接入](../README.md#用户与项目权限)。
+
+## 训练与 AI 预标注
+
+项目页可发起异步训练并查看状态、日志与产物，项目配置第 4 步选择 YOLO 算法和 AI 模型。训练代码位于 `training/`，离线入口为 `yolo-mcp-train` 或 `python -m backend.training.train`。默认 Web 依赖不包含 PyTorch/Ultralytics，需要时安装 `.[training]`；优先复用已有 GPU 运行环境。安装和存储约定见[训练说明](training/README.md)。
+
+服务与训练共用根目录的 Dockerfile，从仓库根目录构建：
+
+```bash
+docker build -t yolo-mcp:local .
+```
+
+## 验证
+
+```bash
+uv run --no-sync pytest
+```
+
+测试使用隔离 SQLite 和临时本地目录，不读取实际凭据。格式采用 Black（Python 3.11、88 列），核心链路同时执行 Flake8 检查。
+
+```bash
+uv run --no-sync black --check .
+uv run --no-sync flake8 .
+```
+
+## 发行包
+
+在完整仓库根目录执行 `uv build --project backend --out-dir dist`。构建钩子会运行 `pnpm build:frontend`，请先安装前端工作区依赖。生成的 wheel 和源码包均包含前端页面，安装后直接运行 `yolo-mcp`；从源码包构建 wheel 无需前端工具链。可编辑安装跳过构建钩子中的前端编译，开发时单独运行 Vite。

yolo_mcp-2.0.0/README.md

@@ -0,0 +1,47 @@
+# YOLO MCP 后端
+
+本目录是独立 Python 项目，源码包名为 `backend`。业务说明、前端运行和参考项目见[仓库 README](../README.md)。
+
+## Web 服务
+
+从本目录执行：
+
+```bash
+uv sync --python 3.11 --frozen --group test
+cp .env.example .env
+# 按需调整 DATA_DIR、USE_AUTO_LABEL 和 DEVICE；签名密钥首次启动时自动生成。
+uv run --env-file .env uvicorn backend.main:app --host 127.0.0.1 --port 8002
+```
+
+`yolo-mcp` 也是服务 CLI 入口。模块导入和 `--help` 不初始化数据库，实际应用启动时通过 `migrations/versions/001_init_db.py` 初始化空库；默认 SQLite 文件名为 `labels.sqlite`。结构调整后使用新库，旧库不会自动迁移。不提供历史结构升级或 to_mysql。
+
+`DATA_DIR` 默认指向用户主目录的 `.yolo-mcp/`。服务首次启动时在此目录生成 `secret.key`，后续启动读取同一密钥；数据库和项目文件也默认保存在此目录。
+
+空库允许一次网页初始化管理员，完成后由管理员添加其他账号。个人令牌在网页管理，MCP 使用 Streamable HTTP `/mcp` 和 `Authorization: Bearer <个人令牌>`；不提供 OAuth 流程。项目拥有者管理配置和成员，协作者可以标注及训练，系统管理员管理全部项目。详细用法见[用户权限与 MCP 接入](../README.md#用户与项目权限)。
+
+## 训练与 AI 预标注
+
+项目页可发起异步训练并查看状态、日志与产物，项目配置第 4 步选择 YOLO 算法和 AI 模型。训练代码位于 `training/`，离线入口为 `yolo-mcp-train` 或 `python -m backend.training.train`。默认 Web 依赖不包含 PyTorch/Ultralytics，需要时安装 `.[training]`；优先复用已有 GPU 运行环境。安装和存储约定见[训练说明](training/README.md)。
+
+服务与训练共用根目录的 Dockerfile，从仓库根目录构建：
+
+```bash
+docker build -t yolo-mcp:local .
+```
+
+## 验证
+
+```bash
+uv run --no-sync pytest
+```
+
+测试使用隔离 SQLite 和临时本地目录，不读取实际凭据。格式采用 Black（Python 3.11、88 列），核心链路同时执行 Flake8 检查。
+
+```bash
+uv run --no-sync black --check .
+uv run --no-sync flake8 .
+```
+
+## 发行包
+
+在完整仓库根目录执行 `uv build --project backend --out-dir dist`。构建钩子会运行 `pnpm build:frontend`，请先安装前端工作区依赖。生成的 wheel 和源码包均包含前端页面，安装后直接运行 `yolo-mcp`；从源码包构建 wheel 无需前端工具链。可编辑安装跳过构建钩子中的前端编译，开发时单独运行 Vite。

yolo_mcp-2.0.0/adapter/persistence/crud_attachment.py

@@ -0,0 +1,92 @@
+from datetime import datetime
+from typing import List, Optional, Tuple
+
+from sqlalchemy.orm import Session
+
+from backend.domain.models.attachment import ProjectAttachment
+
+
+def list_by(
+    db: Session,
+    size: int,
+    ids: List[int] | None = [],
+    project_id: Optional[int] = None,
+    owner_id: Optional[int] = None,
+    after: Optional[int] = None,
+    before: Optional[int] = None,
+    page: Optional[int] = None,
+    sorting: Optional[str] = None,
+) -> Tuple[List[ProjectAttachment], int]:
+    # query filter
+    query_filter = [
+        ProjectAttachment.deleted_at.is_(None),
+        ProjectAttachment.id.in_(ids),
+    ]
+    if owner_id:
+        query_filter.append(ProjectAttachment.created_by == owner_id)
+
+    if before:
+        query_filter.append(ProjectAttachment.id < before)
+    if after:
+        query_filter.append(ProjectAttachment.id > after)
+    if project_id:
+        query_filter.append(ProjectAttachment.project_id == project_id)
+
+    query = db.query(ProjectAttachment).filter(*query_filter)
+
+    # default order by id, before need select last items
+    if before:
+        query = query.order_by(ProjectAttachment.id.desc())
+    else:
+        query = query.order_by(ProjectAttachment.id.asc())
+
+    count = query.count()
+
+    results = query.offset(offset=page * size if page else 0).limit(limit=size).all()
+
+    if sorting:
+        field, order = sorting.split(":")
+        if order == "desc":
+            results = sorted(results, key=lambda x: getattr(x, field), reverse=True)
+        else:
+            results = sorted(results, key=lambda x: getattr(x, field))
+
+    if before:
+        results.reverse()
+
+    return results, count
+
+
+def create(db: Session, attachment: ProjectAttachment) -> ProjectAttachment:
+    db.add(attachment)
+    db.flush()
+    db.refresh(attachment)
+    return attachment
+
+
+def get(db: Session, attachment_id: int) -> ProjectAttachment:
+    return (
+        db.query(ProjectAttachment)
+        .filter(
+            ProjectAttachment.id == attachment_id,
+            ProjectAttachment.deleted_at.is_(None),
+        )
+        .first()
+    )
+
+
+def get_by_ids(db: Session, attachment_ids: List[int]) -> List[ProjectAttachment]:
+    return (
+        db.query(ProjectAttachment)
+        .filter(
+            ProjectAttachment.id.in_(attachment_ids),
+            ProjectAttachment.deleted_at.is_(None),
+        )
+        .all()
+    )
+
+
+def delete(db: Session, attachment_ids: List[int]) -> None:
+    db.query(ProjectAttachment).filter(ProjectAttachment.id.in_(attachment_ids)).update(
+        {ProjectAttachment.deleted_at: datetime.now()}
+    )

yolo_mcp-2.0.0/adapter/persistence/crud_auto_label_job.py

@@ -0,0 +1,50 @@
+from typing import Optional
+from sqlalchemy.orm import Session
+from backend.domain.models.auto_label_job import AutoLabelJob
+
+
+def create(
+    db: Session,
+    project_id: int,
+    user_id: int,
+    sample_count: int,
+    model_name: str,
+    algorithm: str = "yolo",
+) -> AutoLabelJob:
+    job = AutoLabelJob(
+        project_id=project_id,
+        created_by=user_id,
+        sample_count=sample_count,
+        model_name=model_name,
+        algorithm=algorithm,
+    )
+    db.add(job)
+    db.flush()
+    db.refresh(job)
+    return job
+
+
+def get(db: Session, job_id: int) -> Optional[AutoLabelJob]:
+    return db.query(AutoLabelJob).filter(AutoLabelJob.id == job_id).first()
+
+
+def update_status(
+    db: Session, job: AutoLabelJob, status: str, **kwargs
+) -> AutoLabelJob:
+    job.status = status
+    for k, v in kwargs.items():
+        setattr(job, k, v)
+    db.flush()
+    db.refresh(job)
+    return job
+
+
+def increment_progress(db: Session, job: AutoLabelJob, success: bool) -> AutoLabelJob:
+    job.processed_count = (job.processed_count or 0) + 1
+    if success:
+        job.success_count = (job.success_count or 0) + 1
+    else:
+        job.failed_count = (job.failed_count or 0) + 1
+    db.flush()
+    db.refresh(job)
+    return job

yolo_mcp-2.0.0/adapter/persistence/crud_pre_annotation.py

@@ -0,0 +1,67 @@
+from datetime import datetime
+from typing import List, Tuple
+
+from sqlalchemy.orm import Session
+
+from backend.domain.models.pre_annotation import ProjectPreAnnotation
+
+
+def batch(
+    db: Session, pre_annotations: List[ProjectPreAnnotation]
+) -> List[ProjectPreAnnotation]:
+    db.bulk_save_objects(pre_annotations, return_defaults=True)
+    return pre_annotations
+
+
+def list_by(
+    db: Session,
+    project_id: int | None = None,
+    sample_name: str | None = None,
+    after: int | None = None,
+    before: int | None = None,
+    page: int | None = None,
+    sorting: str | None = None,
+    size: int | None = 10,
+) -> Tuple[List[ProjectPreAnnotation], int]:
+
+    # query filter
+    query_filter = [ProjectPreAnnotation.deleted_at.is_(None)]
+    if before:
+        query_filter.append(ProjectPreAnnotation.id < before)
+    if after:
+        query_filter.append(ProjectPreAnnotation.id > after)
+    if project_id:
+        query_filter.append(ProjectPreAnnotation.project_id == project_id)
+
+    if sample_name:
+        query_filter.append(ProjectPreAnnotation.sample_name == sample_name)
+
+    query = db.query(ProjectPreAnnotation).filter(*query_filter)
+
+    # default order by id, before need select last items
+    if before:
+        query = query.order_by(ProjectPreAnnotation.id.desc())
+    else:
+        query = query.order_by(ProjectPreAnnotation.id.asc())
+
+    count = query.count()
+
+    results = query.offset(offset=page * size if page else 0).limit(limit=size).all()
+
+    if sorting:
+        field, order = sorting.split(":")
+        if order == "desc":
+            results = sorted(results, key=lambda x: getattr(x, field), reverse=True)
+        else:
+            results = sorted(results, key=lambda x: getattr(x, field))
+
+    if before:
+        results.reverse()
+
+    return results, count
+
+
+def delete(db: Session, pre_annotation_ids: List[int]) -> None:
+    db.query(ProjectPreAnnotation).filter(
+        ProjectPreAnnotation.id.in_(pre_annotation_ids)
+    ).update({ProjectPreAnnotation.deleted_at: datetime.now()})