Install apps on your Tiiny

Apps from the catalog run on your computer and talk to your Tiiny Pocket Lab over its local API. One command-line tool installs, starts and updates them.

Install the farm CLI

Python 3.9 or newer. macOS, Linux and Windows.

pip install tiinyapp-farm

If pip answers "externally managed environment" (Homebrew Python, recent Debian), use pipx install tiinyapp-farm instead.

Check it: farm --version

Connect your Tiiny

The CLI asks for two values once and saves them in ~/.tiinyapps/device.json, readable only by you.

farm device

API base URL: On a Mac with the TiinyOS client installed: http://openai.api.tiiny/v1
From any other computer on your network: http://<your-tiiny-ip>/v1
API key: TiinyOS → Settings → API Key. Copy it.

Run farm device again to change either value.

Install and run an app

Pick an app in the catalog. Its page shows what it needs and what it asks for before you install it.

farm install titanium-tiiny-bot
farm start titanium-tiiny-bot

farm list: installed apps and whether they are running
farm stop <id>: stop one
farm update <id>: update to the newest release, then start it again
farm remove <id>: uninstall

Apps declare the access they use (microphone, files, network, your Tiiny). The CLI shows that before installing; it does not sandbox them. Read the source if that matters to you: every app in the catalog ships it.