Skip to content
ukkin Star on GitHub
beginner 10 minutes

Install Ukkin and grant the Accessibility permission

Ukkin drives apps through the Android Accessibility Service, so nothing runs until you enable it. This guide gets the app onto an Android device and grants the one permission agents need.

  1. 1

    Get the source

    Clone the repository. Ukkin is MIT-licensed Flutter.

    git clone https://github.com/neul-labs/ukkin
  2. 2

    Build for Android

    With Flutter 3.1.5+ and an Android device or emulator on API 21+, build and install the app.

    flutter run
  3. 3

    Open Accessibility settings

    On the device, go to Settings → Accessibility → Ukkin. This is where Android exposes the toggle Ukkin needs.

  4. 4

    Enable the service

    Turn on the Ukkin Accessibility Service and confirm the permission prompt. Agents can now read the screen and interact with installed apps.

Why this permission is required

  • ▸Ukkin reads the on-screen accessibility tree and dispatches taps, typing, and scrolls through it.
  • ▸Without the Accessibility Service enabled, agents cannot perceive or act on other apps — by design.
  • ▸iOS automation is on the Phase 4 roadmap and is not available yet.

More guides in the index, or read the architecture to see how agents perceive and act.