Repolode
投稿する
MaaXYZ

MaaXYZ/MaaFramework

Windows、Linux、macOS、Android向けに、画像認識を活用した自動化やブラックボックステストツールを構築するLGPL-3.0のC++フレームワーク。

GitHub で見る公式サイト
スター
5,036
フォーク
579
未解決の Issue
124
最終コミット
23 時間前

これは何？

MaaFrameworkは、画像認識で画面上のターゲットを特定し、入力をシミュレートしてインターフェースを操作するブラックボックス自動化テストフレームワークです。C++で実装されており、操作をひとつずつコードに書くのではなく、認識とアクションを組み合わせたパイプラインとしてタスクを定義できるよう設計されています。

タスク定義用のローコードなパイプラインプロトコルに加え、アプリケーションに組み込むための統合APIも提供しています。公式バインディングとパッケージはPython、C#、Node.js、Go、Rust向けに用意されており、READMEでは再利用可能なプロジェクトをパッケージ化するためのProjectInterfaceプロトコルについて説明されています。

READMEには、Windows、Linux、macOS、Androidが対応プラットフォームとして記載されています。また、コミュニティが開発したGUIフロントエンド、デバッガー、ログアナライザー、ゲーム固有のアシスタントも数多く構築されています。

主な機能

  • 01画像認識でUI要素を特定し、入力をシミュレートして操作します。
  • 02ローコードなパイプラインプロトコルで自動化タスクを定義できます。
  • 03複数の言語向けに公式バインディングを備えた統合APIを提供します。
  • 04Windows、Linux、macOS、Androidで動作します。
  • 05ProjectInterfaceプロトコルを通じて、再利用可能なプロジェクトのパッケージ化をサポートします。

ユースケース

  • APIのないゲームやアプリケーションで、繰り返し行う操作を自動化する。
  • ソースコードレベルのフックが利用できないソフトウェアで、ブラックボックスUIテストを実行する。
  • GUIまたはCLIから他のユーザーが実行できる、再利用可能な自動化プロジェクトを構築する。

クイックスタート

  1. 1

    docs フォルダにあるクイックスタートガイドを開きます

  2. 2

    言語バインディング（Python、Node、Go、Rust、C#）を選び、README に記載されているパッケージレジストリからインストールします

使う前に知っておきたいこと

  • LGPL-3.0 の下でライセンスされています。ライブラリの改変には、このコピーレフトライセンスの条件が適用されます。

トピック

#automation#computer-vision#image-recognition#black-box-testing#cpp#gui-automation

よくある質問

MaaFramework とは？
Windows、Linux、macOS、Android向けに、画像認識を活用した自動化やブラックボックステストツールを構築するLGPL-3.0のC++フレームワーク。 MaaFrameworkは、画像認識で画面上のターゲットを特定し、入力をシミュレートしてインターフェースを操作するブラックボックス自動化テストフレームワークです。C++で実装されており、操作をひとつずつコードに書くのではなく、認識とアクションを組み合わせたパイプラインとしてタスクを定義できるよう設計されています。
MaaFramework は無料で使えますか？ライセンスは？
MaaFramework は LGPL-3.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
MaaFramework は今もメンテナンスされていますか？
活発にメンテナンス中。MaaFramework の最終コミットは 2026年10月19日 です。
MaaFramework は何に使えますか？
APIのないゲームやアプリケーションで、繰り返し行う操作を自動化する。 ソースコードレベルのフックが利用できないソフトウェアで、ブラックボックスUIテストを実行する。 GUIまたはCLIから他のユーザーが実行できる、再利用可能な自動化プロジェクトを構築する。
MaaFramework のインストール方法は？
docs フォルダにあるクイックスタートガイドを開きます 言語バインディング（Python、Node、Go、Rust、C#）を選び、README に記載されているパッケージレジストリからインストールします
MaaFramework はどこで入手できますか？
ソースコードとインストール手順は GitHub にあります：https://github.com/MaaXYZ/MaaFramework

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト