whatisgithub

What is munk-ai?

chaxiu/munk-ai — explained in plain English

Analysis updated 2026-05-18

28Audience · developerComplexity · 3/5LicenseSetup · moderate

In one sentence

A local testing tool that runs AI-written app changes on real devices and browsers, then feeds screenshots and logs back to AI coding agents so they can fix bugs automatically.

Mindmap

mindmap
  root((munk ai))
    What it does
      Runs app test plans
      Captures screenshots and logs
      Feeds results to AI agents
    Tech stack
      Python
      FastAPI
      OpenCV
      Playwright
      Vue 3
    Use cases
      Verify AI generated code
      Automate manual QA
      Connect via MCP
    Audience
      Developers
      Vibe coders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Automatically verify that an AI coding agent's app changes actually work

USE CASE 2

Run a plain-language test plan on a real Android, iOS, or web app

USE CASE 3

Capture screenshots, UI trees, and logs as evidence when a test fails

USE CASE 4

Connect a coding assistant to the tool via MCP for a closed feedback loop

What is it built with?

PythonFastAPIOpenCVPlaywrightVue 3TypeScript

How does it compare?

chaxiu/munk-aialicankiraz1/codexqbamirmushichge/vibemotion
Stars282828
LanguagePythonPython
Setup difficultymoderateeasymoderate
Complexity3/53/53/5
Audiencedeveloperdeveloperdesigner

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Currently macOS only, Windows and Linux support are on the roadmap.

Modified versions must also be open sourced, including when used to provide a network service.

So what is it?

Munk AI is a testing tool that watches apps run on real devices and browsers, then reports what it sees back to AI coding tools so they can fix problems without a human in the loop. The central problem it addresses is that AI tools are now quite good at writing code, but after the code is written, someone still has to open the app, tap through screens, check whether things work, take screenshots of failures, and describe what went wrong. Munk AI automates that verification step. When a developer or an AI coding agent makes a change to an Android, iOS, or web app, Munk AI can take a plain-language description of what the app should do, convert it into a test plan, execute that plan on a real device or browser, and produce structured output: screenshots, UI element trees, and runtime logs. If something fails, that evidence goes back into the coding agent's context so it can attempt a fix, creating a closed loop that does not require a human to click through each build. The tool runs locally on macOS (with Windows and Linux support on the roadmap). Installation is a single shell command, and it starts a local web interface for managing tests, recordings, and results. It also exposes an API and supports MCP, a protocol that lets coding assistants call tools directly, so it can be connected to AI development environments without extra configuration. Under the hood the core runtime is Python, using FastAPI and a computer-vision library called OpenCV to analyze what appears on screen visually rather than relying on fragile element selectors. Android testing uses uiautomator2, web testing uses Playwright with a Chromium browser, and the local web UI is built with Vue 3 and TypeScript. The project is under active development. The repository is public but core modules are being opened in stages. It is licensed under AGPL-3.0.

Copy-paste prompts

Prompt 1
Explain how Munk AI turns a plain-language app description into an executable test plan.
Prompt 2
Show me how to install Munk AI on macOS and connect it to an AI coding assistant via MCP.
Prompt 3
Walk me through how Munk AI uses computer vision instead of element selectors to test screens.
Prompt 4
Explain the closed-loop workflow where test failures get fed back into a coding agent's context.

Frequently asked questions

What is munk-ai?

A local testing tool that runs AI-written app changes on real devices and browsers, then feeds screenshots and logs back to AI coding agents so they can fix bugs automatically.

What license does munk-ai use?

Modified versions must also be open sourced, including when used to provide a network service.

How hard is munk-ai to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is munk-ai for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.