← all repositories
chaxiu/munk-ai

Your AI writes code; this engine verifies it on real devices

It exists because AI coding agents still need a human to compile builds, click through UIs, and explain what broke.

1.1k stars Python AgentsLLMOps · Eval
munk-ai
Collecting fresh signals — velocity needs a few days of history.
star history

What it does

Munk AI is a local-first testing engine that turns natural-language requirements into structured test plans and executes them on real Android devices, iOS simulators or hardware, and Web browsers. It captures visual evidence—screenshots, UI trees, and runtime logs—and feeds structured failure context back into coding agent workflows. The goal is to replace the human-as-test-operator bottleneck with an autonomous validation loop that improves over time.

The interesting bit

The engine treats execution history as training data: failed runs, retries, and stuck states are distilled into knowledge candidates that refine future planning and verification. It is essentially trying to build institutional QA memory without the institutional QA headcount.

Key highlights

  • Visual-first validation using device perception rather than brittle XPath or DOM selectors.
  • Multi-surface entry points—CLI, local Web UI, API, and MCP—so developers, QA, and autonomous agents share the same core orchestration.
  • Real-device execution via adb/uiautomator2 for Android, Playwright/Chromium for Web, and WebDriverAgent/simctl for iOS.
  • Self-improving post-action loop where optimization and knowledge agents digest evidence from past runs.
  • Local-by-default architecture, keeping device control and data inside your own network.

Caveats

  • Android is the most mature path and the only platform that supports recording today; iOS and Web execution are explicitly marked as MVP stage.
  • Windows and Linux ports are currently beta or incomplete, with macOS being the stable tier.
  • The project is under active development and lacks published CI/release automation and contributor documentation.

Verdict

Teams already using AI coding agents and struggling with the “compile, click, and screenshot” verification gap should look here. If you are looking for a polished, cross-platform CI-native solution with mature iOS/Web parity, this is still early.

Frequently asked

What is chaxiu/munk-ai?
It exists because AI coding agents still need a human to compile builds, click through UIs, and explain what broke.
Is munk-ai open source?
Yes — chaxiu/munk-ai is open source, released under the Apache-2.0 license.
What language is munk-ai written in?
chaxiu/munk-ai is primarily written in Python.
How popular is munk-ai?
chaxiu/munk-ai has 1.1k stars on GitHub.
Where can I find munk-ai?
chaxiu/munk-ai is on GitHub at https://github.com/chaxiu/munk-ai.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.