> ## Documentation Index
> Fetch the complete documentation index at: https://yoqa.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Local testing

> Run Yoqa entirely on your Mac with local devices and BYO models.

Phase 1 is **local-only**. Everything — Appium, vision calls, catalog, reports — runs on your machine.

## What works locally

| Capability                                  | Local                                                                             |
| ------------------------------------------- | --------------------------------------------------------------------------------- |
| iOS Simulator / Android Emulator            | Yes                                                                               |
| Physical iOS / Android devices              | Yes (with toolchain setup)                                                        |
| Local `.ipa` / `.app` / `.apk` builds       | Yes                                                                               |
| CLI device connector                        | Yes                                                                               |
| Autonomous agent runs                       | Yes (BYO provider)                                                                |
| Manual Inspector                            | Yes                                                                               |
| Cloud device farm                           | Not yet                                                                           |
| GitHub Actions (your runner + sim/emulator) | [GitHub Actions](/docs/github-actions) — HTML report + `examples/expo-demo` smoke |
| Hosted Yoqa CI / device farm                | Not yet                                                                           |
| Public API                                  | Not yet                                                                           |

## When local is the right choice

* Fast feedback while developing a feature.
* Hardware or OS versions you already own.
* Privacy — builds and screenshots stay on disk.
* Debugging WDA / Appium issues with full control.

## Requirements

* macOS with the Yoqa [desktop app](/docs/desktop-app) / runner
* [Device preparation](/docs/device-preparation) for the platforms you use
* An [AI provider](/docs/providers) for grounding and agent runs

You can also wire `yoqa` into GitHub Actions on `macos-*` with a simulator or emulator — see [GitHub Actions](/docs/github-actions). Cloud device farm and hosted Yoqa runners are still unshipped.

<CardGroup cols={2}>
  <Card title="Desktop application" icon="desktop" href="/docs/desktop-app">
    Local host UI
  </Card>

  <Card title="Device preparation" icon="mobile" href="/docs/device-preparation">
    Xcode / adb / WDA
  </Card>
</CardGroup>