Metadata-Version: 2.4
Name: nyxpy-fw
Version: 0.1.0
Summary: Game automation framework with macro APIs, CLI, and GUI
Project-URL: Homepage, https://github.com/niart120/Project_NyX
Project-URL: Documentation, https://niart120.github.io/Project_NyX/
Project-URL: Repository, https://github.com/niart120/Project_NyX
Project-URL: Issues, https://github.com/niart120/Project_NyX/issues
Author-email: niart120 <38847256+niart120@users.noreply.github.com>
License: MIT License
License-File: LICENSE
Keywords: automation,capture,gui,macro,serial
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Typing :: Typed
Requires-Python: <3.14,>=3.12
Requires-Dist: chardet<6.0.0,>=5.2.0
Requires-Dist: cv2-enumerate-cameras<2.0.0.0,>=1.3.3
Requires-Dist: loguru<0.8.0,>=0.7.3
Requires-Dist: mss>=10.2.0
Requires-Dist: numpy<2.4.0,>=2.3.5
Requires-Dist: opencv-python<5.0.0.0,>=4.13.0.92
Requires-Dist: paddleocr<3.6.0,>=3.5.0
Requires-Dist: paddlepaddle<3.3.0,>=3.2.2
Requires-Dist: pillow<13.0.0,>=12.2.0
Requires-Dist: pyserial<4.0,>=3.5
Requires-Dist: pyside6<7.0.0,>=6.11.0
Requires-Dist: requests<3.0.0,>=2.34.0
Requires-Dist: setuptools>=82.0.1
Requires-Dist: tomlkit<0.14.0,>=0.13.3
Provides-Extra: windows
Requires-Dist: windows-capture<3.0.0,>=2.0.0; (sys_platform == 'win32') and extra == 'windows'
Description-Content-Type: text/markdown

# NyXPy-FW

![Alpha Version Badge](https://img.shields.io/badge/Status-Alpha-orange)

NyXPy-FW (Project NyX) は、キャプチャデバイスから取得した画面とシリアル通信デバイス経由のコントローラー入力を組み合わせる、ゲーム自動化向けの Python フレームワークです。GUI、CLI、マクロ API、ログ、実行成果物の保存をまとめて提供します。

**注意: このソフトウェアは開発中のアルファ版です。機能や設計が変更される可能性があります。**

![GUI Screenshot](docs/assets/sample_macro_screenshot.png)

## 特徴

- PySide6 による GUI と `nyxpy` CLI
- キャプチャデバイスのリアルタイムプレビュー
- シリアル通信デバイス経由のコントローラー操作
- マクロ実行基盤
- 実行ログ、スナップショット、実行成果物の保存
- Discord / Bluesky への外部通知

## 必要なもの

- [uv](https://github.com/astral-sh/uv)
- 対応 OS: Windows / macOS / Linux
- キャプチャデバイス
- CH552 プロトコルなど NyX が対応するシリアル通信デバイス

## クイックスタート

PyPI から導入する場合は、空の workspace 用ディレクトリを作成し、その中で `nyxpy init` を実行します。

```console
uv tool install nyxpy-fw
mkdir nyx-workspace
cd nyx-workspace
nyxpy init
nyxpy gui
```

`nyxpy init` は確認用の `sample_macro` も生成します。空の workspace だけが必要な場合は、`nyxpy init --blank` を使います。


## ドキュメント

利用者向けガイド、マクロ開発者向けドキュメント、API リファレンスは GitHub Pages で公開しています。

- [NyXPy-FW Docs](https://niart120.github.io/Project_NyX/)
- [利用者向けガイド](https://niart120.github.io/Project_NyX/user-guide/)
- [マクロ開発者向けドキュメント](https://niart120.github.io/Project_NyX/macro-development/)
- [API リファレンス](https://niart120.github.io/Project_NyX/api/framework/)

リポジトリ内の Markdown は次の場所にあります。

- [docs/user-guide/README.md](docs/user-guide/README.md)
- [docs/macro-development/README.md](docs/macro-development/README.md)
- [docs/api/framework.md](docs/api/framework.md)

## ライセンス

このプロジェクトは [MIT License](LICENSE) の下でライセンスされています。
