nomix-clicker 0.1.0

iOS device automation via the Nomix Clicker API — simulated touch input with AI screen recognition.

NomixClicker Scripting Library

This is a library of ready-made scripts written in Python and using the free Clicker API.

What Is Clicker?

NomixClicker is a controlling dongle for iOS. It allows manual control, automatic control via API, and fully autonomous AI mode.

Part of the features are work-in-progress, see the Roadmap.

Example: quick script for Reddit warmup.

Installation

Requires Python 3.10+. Install from PyPI:

pip install nomix-clicker

Buy a Clicker device if you don't have it (delivery takes ~2 weeks to any place in the world), then open the Panel and get your API token.

Purchase on the official site only.

Configuration

Provide your API token and device id in either of two ways (environment variables take precedence):

Environment variables:

export NOMIX_API_KEY="your-api-key"
export NOMIX_DEVICE_ID="your-device-id"

Or a config.json in your working directory (copy config.example.json):

{
  "API_KEY": "your-api-key",
  "DEVICE_ID": "your-device-id",
  "API_URL": "https://panel.nomixclicker.com/clicker/v1"
}

Quick start

from nomix_clicker import Clicker, parse_screen, open_app, DEVICE_ID

clicker = Clicker(DEVICE_ID)
open_app(clicker, "Instagram")

screen = parse_screen(clicker)
screen.find_and_click(clicker, "like")

Manual control of iPhones will work out-of-the-box, no setup needed.

Examples

Ready-made example scripts live in the examples/ folder. After installing the package, run one directly, for example:

python3 examples/airplane-mode-iphone-12.py

• instagram-warmup.py - Scrolling Instagram Reels, liking, and commenting with configurable probabilities.
• restart_all_devices.py - Restarts all devices associated with your account.
• airplane-mode-iphone-12.py - Toggles airplane mode on and off on iPhone 12.
• switch-screen-viewing-iphone-12.py - Turns on/off Clicker screen viewing.

Local development

To work on the library itself, install it in editable mode:

pip install -e .