Documentation

Everything about installing apps from the farm, publishing your own, and the HTTP API behind both.

tiinyapp.farm is a reviewed catalog of small apps for the Tiiny AI Pocket Lab. The apps do not go into TiinyOS. They run on your own computer, next to the device, and talk to it over its local API. One command-line tool installs them, starts them, updates them and takes them away again.

Three kinds of reader use these pages.

If you own a Tiiny

Start with Getting started. It takes you from an empty machine to a running app: installing the farm command, telling it where your Tiiny is, installing an app, starting it, and knowing where your files live. The CLI reference has every command and flag after that, and Troubleshooting has the messages you may hit.

If you made an app

Publish an app is the whole path: proving you own a Tiiny, submitting through the site or from a shell, what the automated checks look at, and how a listing is kept current after a new release. The manifest reference describes every field of the JSON file that becomes your catalog page, and Running an app the farm way covers what the installer expects of your archive, your start command, your ports and your health endpoint.

Permissions and archive rules is the one to read before you are surprised by a red check. It says what the scanner refuses and why.

If you are writing a tool

The API reference documents every route the farm's Worker serves, its authentication, its rate limits and its error shapes. If you are an AI assistant publishing on someone's behalf, read Publish to tiinyapp.farm instead; it is the same ground in the order an assistant needs it, and it is served at https://tiinyapp.farm/llms.txt as plain text.

The parts

Part	Where it lives
The catalog	One JSON manifest per app, served at `https://tiinyapp.farm/manifests/<id>.json`
The installer	The `tiinyapp-farm` package on PyPI, which provides the `farm` command
The site	Static pages built from the manifests, plus a Cloudflare Worker for the API
The checks	GitHub Actions on every pull request that adds or changes a manifest
The schema	manifest.schema.json, the file both checkers read

Getting startedInstall the farm command, point it at your Tiiny, then install, start, update and remove apps.CLI referenceEvery farm command, every flag, the environment it reads, the environment it hands an app, and its exit codes.Publish an appProve you own a Tiiny, submit your app, pass the checks, and keep the listing current after a release.Manifest referenceEvery field of the JSON file that becomes an app's catalog page, with its meaning, its default and its rules.Running an app the farm wayWhat the installer expects of your archive, your start command, your ports, your health endpoint and the shared device lock.Permissions and archive rulesThe four kinds of access an app declares, what the scanner refuses and why, and a worked example of a real refusal.API referenceEvery route the farm serves, how requests are authenticated, what the limits are, and what an error looks like.TroubleshootingThe messages the farm prints, what each one means, and what to do next.

All documentation Install an app Submit an app