MaaFramework

An automation black-box testing framework based on image recognition

Easy to Use · Powerful Recognition · Flexible Extension

Core Features

rocket

Easy to Use

Simple JSON configuration for automation workflows

  • No coding skills required
  • JSON low-code programming
  • Video tutorials included
  • Official MCP support
search

Powerful Recognition

Built-in OCR text recognition and template matching

  • OCR text recognition
  • Template matching
  • Feature detection
  • Deep learning
wrench

Flexible Extension

Support custom recognition and action modules through Agent Server

  • Multi-process architecture
  • Custom recognition/actions
  • Cross-language support

Multiple Solutions for Different Needs

From zero-code to fully customizable, choose the development approach that suits you

Use Cases

Quick start, simple logic implementation

Core Advantages

  • ✓ No coding skills required
  • ✓ Automation through JSON configuration
  • ✓ Video tutorials and project templates
json
{
  "ClickStartButton": {
    "recognition": "OCR",
    "expected": "Start",
    "action": "Click",
    "next": ["ClickConfirmIcon"]
  },
  "ClickConfirmIcon": {
    "recognition": "TemplateMatch",
    "template": "confirm.png",
    "action": "Click"
  }
}

Developer Reviews

Hear what community developers say about MaaFramework

MistEO

MistEO

Project Architect

"

MaaFramework significantly reduced our automation testing development costs. The JSON configuration approach allows non-technical staff to participate in building automation processes. Team collaboration efficiency has greatly improved!

Windsland52

Windsland52

Game Script Developer

"

OCR recognition accuracy is very high, and template matching is stable. Compared to other frameworks, MaaFramework has a gentler learning curve, and the documentation and community support are excellent. Highly recommended!

SweetSmellFox

SweetSmellFox

UI Developer

"

Cross-platform support is excellent - Windows, Linux, macOS all run seamlessly. High code quality, reasonable API design, and strong extensibility. This is one of the most professional automation frameworks I've seen!

Community Projects

Explore real-world applications built by community developers

Ready to Get Started?

Choose the best way to start using MaaFramework

globe

Community Projects

Explore real-world use cases

View Projects →
rocket

Quick Start

Follow tutorials to get started quickly

Start Learning →
package

Integration Docs

Integrate into your project

View Docs →