Install apps on your Tiiny
Apps from the catalog run on your computer and talk to your Tiiny Pocket Lab over its local API. Tiiny App Farm is a small app for Mac, Windows and Linux that installs, starts and updates them for you.
Desktop
All releasesDownload the latest desktop build, or browse every release.
CLILinux
Version 0.1.5 on the desktop. The command line carries everything it needs too: no Docker, nothing to install first.
Prefer the command line?
The farm CLI does everything the app does, on every platform including Linux, and it is the same install directory either way. Start with the app and move to the CLI whenever you like: it finds what the app already put there.
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
The install prints what the app asks for and waits for a yes. In a script, farm install <id> -y answers it.
A start that worked ends with the link to open, what the app is for, and Stop it with: farm stop <id>.
If something already holds the app's port, the farm steps up to the next free port and says so, unless that app's port is fixed. To pick the port yourself: farm start <id> --port 7799.
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.