Git-Agni/prod-FARM-IOS-Core

What it solves

This project provides a way to manage and automate physical iOS devices at scale. It solves the difficulty of operating multiple iPhones for repetitive tasks, specifically targeting scheduled workflows for platforms like TikTok, while providing remote control and monitoring capabilities.

How it works

The system operates as a standalone application consisting of four main processes: a dashboard/API server, a worker, a WDA service, and an Appium instance. It uses WebDriverAgent (WDA) and Appium's XCUITest driver to supervise and control the physical devices. Tasks are managed via a PostgreSQL database for scheduling and recurring jobs, and the system is extensible through a plugin architecture where developers can create versioned tasks and custom device-page panels.

Who it’s for

It is designed for developers and operators who need to automate physical iOS hardware for social media management or other app-based workflows, and who have the necessary technical setup (Xcode, signed WebDriverAgent, and Node.js).

Highlights

• Physical Device Control: Supports live video and remote input for real iOS devices.
• Scheduled Workflows: Includes PostgreSQL-backed scheduling for recurring jobs and execution history.
• Plugin System: Allows the addition of custom task plugins without modifying the core scheduler or routing code.
• TikTok Integration: Comes with a built-in automation plugin specifically for TikTok.
• Versioned Tasks: Ensures that old schedules cannot execute new task contracts by persisting specific task versions.