Metadata-Version: 2.4
Name: kotonebot
Version: 0.9.0
Summary: Kotonebot is game automation library based on computer vision technology, works for Windows and Android.
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: opencv-python~=4.10
Requires-Dist: rapidocr_onnxruntime~=1.4
Requires-Dist: scikit-image~=0.25
Requires-Dist: thefuzz~=0.22
Requires-Dist: pydantic~=2.10
Requires-Dist: ksaa-res~=0.2
Requires-Dist: typing-extensions~=4.12
Requires-Dist: python-dotenv~=1.0
Requires-Dist: onnxruntime~=1.14
Requires-Dist: rich~=13.9
Requires-Dist: numpy
Requires-Dist: mouse>=0.7.1
Provides-Extra: android
Requires-Dist: adbutils>=2.8; extra == "android"
Requires-Dist: uiautomator2>=3.2; extra == "android"
Provides-Extra: windows
Requires-Dist: pywin32; extra == "windows"
Requires-Dist: ahk>=1.8; extra == "windows"
Requires-Dist: win11toast>=0.35; extra == "windows"
Requires-Dist: psutil>=6.1; extra == "windows"
Provides-Extra: dev
Requires-Dist: fastapi~=0.115; extra == "dev"
Requires-Dist: uvicorn~=0.34; extra == "dev"
Requires-Dist: python-multipart~=0.0; extra == "dev"
Requires-Dist: websockets~=14.1; extra == "dev"
Requires-Dist: psutil~=6.1; extra == "dev"
Requires-Dist: twine~=6.1; extra == "dev"
Requires-Dist: build; extra == "dev"
Requires-Dist: snakeviz; extra == "dev"
Requires-Dist: tomli; python_version < "3.11" and extra == "dev"
Requires-Dist: dataclass-wizard; extra == "dev"
Requires-Dist: jinja2~=3.1; extra == "dev"
Requires-Dist: tqdm~=4.67; extra == "dev"
Provides-Extra: all
Requires-Dist: kotonebot[android,dev,windows]; extra == "all"
Dynamic: license-file

# kotonebot
> [!WARNING]
> 本项目仍然处于早期开发阶段，可能随时会发生 breaking change。如果要使用，建议 pin 到一个具体的版本。

kotonebot 是一个使用 Python 编写，基于 OpenCV、RapidOCR 等技术，致力于简化 Python 游戏自动化脚本编写流程的框架。

## 特性
* 层次化引入
  * 包含 Library、Framework、Application 三个不同层次，分别封装到不同程度，可自由选择
* 平台无关的输入输出（截图与模拟点击）
* 基于代码生成的图片资源引用
  * 避免硬编码字符串
* 图像/OCR 识别结果追踪 & 可视化查看工具
* 开箱即用的模拟器管理（目前仅支持 MuMu12 与雷电模拟器）

## 安装
要求：Python >= 3.10

```bash
# Windows Host, Windows Client
pip install kotonebot[windows]
# Windows Host, Android Client
pip install kotonebot[android]
# Development dependencies
pip install kotonebot[dev]
```

## 快速开始
WIP

### 协同开发
有时候你可能想以源码方式安装 kotonebot，以便与自己的项目一起调试修改。此时，如果你以 `pip install -e /path/to/kotonebot` 的方式安装，Pylance 可能无法正常静态分析。
解决方案是在 VSCode 里搜索 `python.analysis.extraPaths` 并将其设置为你本地 kotonebot 的根目录。

## 文档
WIP

## 其他
本项目分离自 [KotonesAutoAssistant](https://github.com/XcantloadX/kotones-auto-assistant)，因此 c69130 以前的提交均为 KotonesAutoAssistant 的历史提交。

由于使用 filter-repo 移除了大量无用文件，因此历史提交信息和更改的文件可能无法完全对应。
