Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL

kevinbadi/Kevs-IOS-Agents

AI Engineering

Self-hosted system for controlling a farm of real iPhones from a Mac with scheduling and TikTok/Instagram automation.

140
41
TypeScript
Apache-2.0
2 months old

What it does

Phone Farm iOS is a standalone, self-hosted application for operating physical iOS devices from a Mac. It handles guided device registration, WebDriverAgent (WDA) and Appium supervision, live video and remote input, and a PostgreSQL-backed scheduler for recurring jobs. Built-in plugins provide TikTok and Instagram workflows, while the dashboard/API server and execution history let you inspect what ran.

The scheduler persists each task as pluginId, taskType, taskVersion, and a JSON payload, so an existing schedule cannot silently pick up a changed task contract. Task plugins are the extension point: they can add versioned tasks, registration checks, device-page panels, namespaced HTTP routes, and declared WDA extensions. src/example-plugin.ts shows a minimal open-app plugin.

Quick start

You need Node 22+, PostgreSQL, Xcode, a signed real-device WebDriverAgent, and Appium's XCUITest driver. From a clone of the repository:

npm install
cp .env.example .env
npm run appium:install-driver
npm run db:up
npm run db:migrate
npm run wda:prepare

Then start the four long-lived processes, each in its own terminal or under launchd/systemd for an always-on host:

npm run appium
npm run wda:service
npm run worker
npm run web

After that, open the dashboard and follow the guided registration to add a device. The getting-started guide covers install, configuration, running, and device registration; the architecture doc explains the four processes and data stores. A hosted live demo and walkthrough are available at gethandler.ai/ios-farm.

Constraints and security

A local loopback bind works without authentication, but WEB_HOST outside loopback requires an ESM authentication provider via PHONE_FARM_AUTH_PLUGIN; startup deliberately fails otherwise. For shared or exposed deployments, the project recommends supplying your own AuthProvider and process supervision rather than forking. Read SECURITY.md before exposing the dashboard.

TikTok and Instagram support is enabled by default. Additional task plugins are loaded as comma-separated ESM package names through PHONE_FARM_PLUGINS. Plugin compatibility and trust rules are documented in PLUGIN_DEVELOPMENT.md.

The repository uses GitHub-hosted CI only; its policy says not to connect production devices, Apple signing material, production databases, self-hosted runners, or deployment credentials to PR-triggered workflows. The project is licensed under Apache-2.0.

HotRepo's take

No HotRepo ranking snapshots or discussion threads are available for this repository, so there is no site record to situate its growth. The useful signal is in the design: the versioned task contract, documented process split, and optional auth-provider boundary address the practical risks of tying schedules to a moving plugin API and of exposing device control beyond localhost. Readers evaluating it should weigh the operational requirement for a signed WDA and a physical iPhone setup, which is where most of the effort will go.

Written by AI from the project's README, updated . The project's own docs are the source of truth.

You might also like

  1. mylea1/phongentControls multiple Android device agents from an iOS or Android master device with natural-language tasks and live screens.Kotlin362
  2. phone-harness/mcpA hosted MCP server that lets AI agents control real iPhones and Android emulators in the cloud.Python812
  3. swipt-automation/swiptA Go-based platform for automating iPhones and iPads via a TypeScript SDK, CLI, and MCP-compatible API.Go507
  4. JosssphZhou/pokiLet Claude Code, Codex, or other MCP clients drive a real iPhone from a Mac, without jailbreak or extra hardware.JavaScript109
  5. phoneuse-official/phoneuseOpen-source tools to drive a USB-connected iPhone from a Mac with prompts, live video, REST and MCP.Python132