Repolode
Submit
Git-Agni

Git-Agni/prod-FARM-IOS-Core

Self-hosted software for running and automating a rack of real iPhones from a Mac, with live control and scheduled TikTok workflows.

View on GitHubWebsite
Stars
1,850
Forks
328
Open issues
4
Last commit
2 months ago

What is it?

Phone Farm iOS is a standalone, self-hosted application for operating physical iOS devices and running scheduled workflows on them. It covers guided device registration, WebDriverAgent and Appium supervision, live video with remote input, and a PostgreSQL-backed scheduler that handles one-off and recurring jobs, uploads, and execution history. A dashboard and API server sit on top of these pieces.

Tasks are stored with a plugin ID, task type, task version, and JSON payload, so a saved schedule does not silently run under a newer task contract. TikTok automation ships as a built-in plugin, and additional task plugins can be loaded as ESM packages. Plugins can add versioned tasks, registration checks, device-page panels, and namespaced HTTP routes without changing core scheduler code.

The app runs locally without authentication on a loopback address. Exposing the dashboard beyond loopback requires supplying an authentication provider, and the process fails to start otherwise. Requirements include Node 22+, PostgreSQL, Xcode, a signed real-device WebDriverAgent build, and Appium's XCUITest driver.

Key features

  • 01Guided registration and supervision of real iOS devices via WebDriverAgent and Appium
  • 02Live video and remote input for connected iPhones
  • 03PostgreSQL-backed scheduler with one-off and recurring jobs
  • 04Versioned task plugins that keep old schedules from running new contracts
  • 05Built-in TikTok automation plugin with an execution history

Use cases

  • Operating a small set of physical iPhones from one Mac for app testing
  • Scheduling recurring TikTok workflows across multiple devices
  • Building custom iOS device automation through the plugin system

Quick start

  1. 1

    Install Node dependencies

    npm install
  2. 2

    Create your environment file from the example

    cp .env.example .env
  3. 3

    Start PostgreSQL, run migrations, and prepare WebDriverAgent (see README for the full prerequisites)

    npm run db:up
  4. 4

    Start the dashboard and API server

    npm run web

Things to know

  • Requires a Mac with Xcode, real iPhones, and a signed WebDriverAgent build.
  • Needs Node 22+ and a PostgreSQL database.
  • Authentication is optional on loopback, and you must supply your own AuthProvider before exposing it beyond loopback.

In collections

Self-hosted appsDatabases & SQL tools

Topics

#ios-automation#appium#webdriveragent#device-farm#scheduler#postgresql#self-hosted#marketing-automation#phone-farm#tiktok-automation-script

FAQ

What is prod-FARM-IOS-Core?
Self-hosted software for running and automating a rack of real iPhones from a Mac, with live control and scheduled TikTok workflows. Phone Farm iOS is a standalone, self-hosted application for operating physical iOS devices and running scheduled workflows on them. It covers guided device registration, WebDriverAgent and Appium supervision, live video with remote input, and a PostgreSQL-backed scheduler that handles one-off and recurring jobs, uploads, and execution history. A dashboard and API server sit on top of these pieces.
Is prod-FARM-IOS-Core free to use? What license does it have?
prod-FARM-IOS-Core is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is prod-FARM-IOS-Core still maintained?
Updated within 6 months. The last commit to prod-FARM-IOS-Core was on Sep 7, 2026.
What can I use prod-FARM-IOS-Core for?
Operating a small set of physical iPhones from one Mac for app testing Scheduling recurring TikTok workflows across multiple devices Building custom iOS device automation through the plugin system
How do I install prod-FARM-IOS-Core?
Install Node dependencies: npm install Create your environment file from the example: cp .env.example .env Start PostgreSQL, run migrations, and prepare WebDriverAgent (see README for the full prerequisites): npm run db:up Start the dashboard and API server: npm run web
Where can I get prod-FARM-IOS-Core?
The source code and installation instructions are on GitHub: https://github.com/Git-Agni/prod-FARM-IOS-Core

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects