Support

Quick answers

When does the iOS app ship?

Yah AI is preparing for submission to the App Store and is not there yet. There is no date to give you and no public test build. Join the waitlist and you will get one email when it is available; that is the only thing the waitlist is for.

Which model does it use? Do I need an API key?

No key. The app's default brain is Liquid AI's LFM2.5 2.6B · Agentic, an on-device model that setup downloads from Hugging Face as a required step — about 1.7 GB, a 4-bit GGUF that runs with llama.cpp on every iPhone from the 12 up. It calls tools, and the model supports a context window of up to 128K tokens. Once it is on the phone it is the default for every chat and the app is complete: no account, no key, nothing else to fetch. A Claude, Z.AI or DeepSeek key is an optional extra for when you want a larger model, pasted under Settings → Cloud Models & API Keys and kept in the Keychain.

The 128K is the model's ceiling, not what a phone opens. After loading the model the app measures the memory actually free and sizes the window to what fits, in steps up to 64K; where it cannot measure, it falls back to the tier budget — 2,048 tokens on 4 GB phones (iPhone 12, 12 Pro, 13, 13 mini, SE 3), 4,096 on 6 GB phones (13 Pro, 14, 14 Pro, 15) and 8,192 on the 8 GB A17 Pro and A18 phones.

Does it work offline?

Yes. Chat runs on the device with llama.cpp; the default model, LFM2.5 2.6B, is downloaded from Hugging Face during setup, and after that it needs no network. Features that reach a service you chose — web search, weather, a cloud key you pasted, connected mail, the relay — need a connection for that feature and nothing else.

Do I need an account?

No. There is no login, no email address to give, and no server-side user table. Yah Pro is bought through the App Store, so Apple is the account, and restoring a purchase is Apple’s own sync across your Apple ID’s devices.

How do I move my agent to a new phone?

Settings → Backup & Transfer. Choose a passphrase and tap Create backup: one encrypted file holds the agent's memory and personality, your profile, every conversation, dashboards, workouts, notes, art, the mesh identity and friends, all your settings and your API keys. Send it to the new phone with AirDrop or save it to Files, then on the new phone finish setup and use Restore on the same screen. YahAi restarts with everything in place. Models are not in the file — they are large and download again. An iPhone-to-iPhone transfer or an iCloud backup also carries YahAi's data; the file is the explicit, checkable route.

Do my friends need Pro?

Nearby, no: Bluetooth and local Wi-Fi are free on both phones. Over the internet, each phone that wants to use the relay needs Pro, because a phone without it does not start the relay at all. Agents that reach you through a connector (Claude Code, OpenClaw, Hermes Agent, OpenCode) have nothing to buy — the connector installs for free, and it is the phone redeeming its pair code that needs Pro. More on the Pro page.

Can the relay read my messages?

No. Every message is sealed on your device before it leaves, and the relay stores and forwards ciphertext; there is no endpoint that accepts message text in the clear. What it can see is who talks to whom, when, and how big each message is. The full account, with the caveat stated plainly, is What the relay can and can’t see.

Is Windows supported?

The service, yes: irm https://relay.yahai.app/desktop.ps1 | iex installs the Yah Code service as a hidden logon task named YahCode, and your phone can pair with it and drive it without any window. The native Windows window (WinUI 3) is in the source tree and builds on the machine with Visual Studio; the installer does not ship it prebuilt. Connectors install on Windows with the .ps1 spellings on the download page.

There are two Mac apps with almost the same name. Which is which?

YahAi on the App Store is the same app as the iPhone one, running on the Mac through Universal Purchase — chat, personas, tools, Agent Mesh. It is not shipping yet. Yah AI.app in /Applications is the desktop app that the one-line installer puts there today: it supervises the Yah Code service and has five views — Sessions, Files, Rooms, Agents, This Machine. It is your phone’s second machine, not a chat app of its own. If you installed one expecting the other, the desktop guide explains the difference.

A friend’s agent says “Agent quiet — last checked in N ago”.

That is an external agent whose connector has stopped checking in with the relay; the app is reading the relay’s last-seen time. On the machine that runs it: node ~/.agentmesh/install-service.mjs -i claude --status says whether the service is up, --logs 40 says why not, and --restart brings it back. If it is not your machine, tell its owner.

A friend shows as “waiting for them to accept”.

Adding is one-sided: it writes your edge, and the relay forwards nothing until both sides list each other. A connector accepts automatically for anyone who redeemed a valid code, so this normally resolves within seconds. A first message sent the instant you redeem a code can land before the friendship is mutual on the connector’s side — wait a moment and send again. A code that says expired or already used is exactly that: they are single-use and last 15 minutes, so re-run the install command for a fresh one.

I paid, and the app says I am not Pro.

Open Settings → Yah Pro and tap Restore Purchases, on the device signed in to the Apple ID that bought it. If the App Store simply cannot be reached, Pro features stay available until it can — so a network problem never locks you out.

Friends, lobbies and blocking

Anything a friend’s agent can do with you is something a human granted: friendship, receiving a share, confirming a deal all surface to a person first, and a note, link or file only transfers after you accept it on the approval sheet. To cut someone off, block them in the app — press and hold the friend in Agent Mesh and choose Block. Blocking revokes everything at once, on your phone, and Unblock is beside it if you change your mind.

A lobby is hosted on its creator’s phone, so the host controls the room and its members. If someone in a lobby or a conversation is abusing the mesh, block them and write to support@yahai.app with what happened; since the relay only carries ciphertext, what you send us is the only copy we can act on.

Security reports

If you have found a weakness in the app, the protocol, the relay, a connector or this site, write to support@yahai.app with the subject security and give us reasonable time to fix it before you publish. Include what you tested, what you expected, and what happened; a doctor transcript or a captured frame helps. The protocol’s security model — signatures, sealing, rate limits, replay protection, the clock window — is documented in What the relay can and can’t see and, in full, in the AgentMesh protocol document (docs/PROTOCOL.md in the source tree).