SOURCE ↗
Browse documentation

Common questions

How do I get NANI?

Join the public beta through TestFlight. The current app requires iOS 26 or later. You do not need to join the email list to test NANI. See setup and requirements.

Do I have to use the assistant?

You can use Receive, Send, Swap and Bridge directly from Wallet. These controls work independently of your AI provider.

Are chats processed on my device?

That depends on your provider. NANI is the initial AI provider, with a sharing explanation before the first message. You can select your own provider or an on-device model on supported hardware. On-device inference still allows tools and wallet actions to make network requests. See AI assistant.

Which on-device model is available?

The current built-in choice is Bonsai 2 · 4B, which supports text and images. Its weights are about 1.87 GB, with additional memory and setup requirements. An existing NANI 2B selection can remain usable. You can also add compatible public Hugging Face MLX text models in Settings → AI provider → Add model. Custom models do not have Bonsai’s Unfiltered switch.

How do I switch models or use Unfiltered?

Tap the model pill in the chat composer to open Select model. More models opens provider settings. Bonsai starts in Normal mode; turning on Unfiltered may need several minutes of local preparation. Tap Done after setup. It changes reply behavior, not private-chat status or wallet approvals, and answers can be less reliable.

Can I send or swap from chat without AI?

Type /send or /swap as the first word of your draft and choose the matching quick action. The local panel lets you enter or edit the details before native wallet review. It does not send automatically and needs no AI provider. Partial or unknown slash commands do not show an action.

Can the assistant access my private key?

Wallet signing secrets are kept separate from assistant requests. Messages, attachments and tool results can be sent to your selected provider, so keep recovery phrases, private keys and API keys out of chat. Review every transaction proposal before approving it.

Which networks can I use?

Check the network picker in your build. NANI supports Ethereum-compatible networks. Available actions vary by network. See Wallet for the current iPhone network list.

Why is a balance or asset missing?

Open Balance details for network failures, discovery coverage, saved-data age and missing prices, then retry or refresh. A partial or unpriced total is not proof that an asset is absent. Testnet balances are separate from the mainnet fiat total, and manually tracking a collectible does not prove ownership.

Why can’t I swap or bridge on this network?

These actions need supported routes, account setup and fee evidence as well as a configured network. They are disabled on testnets. Use Wallet’s quote/review flow for current availability; an assistant research result or old quote does not enable a route.

Did my transaction fail if a reply or request timed out?

Not necessarily. Check the recorded transaction in Activity before sending again. A missing receipt preserves uncertainty; a bridge’s source confirmation is separate from arrival on the destination network. Deleting a chat does not clear a submitted transaction.

Can I connect a website?

Open a site in Explore and review its account connection or signing requests. Each transaction still uses native wallet review. External WalletConnect is not implemented, and browser requests do not support every custom network or RPC configuration.

What will I pay?

Transactions incur network fees. Swaps, bridges and AI services may have additional costs shown by the relevant service or review screen. App pricing will be published with release details.

What happens if I lose my device?

Use your recovery backup on a trusted device. Confirm the restored account addresses and networks before moving funds. Imported accounts need their own backups. NANI support cannot recover a lost recovery phrase or private key.

Can I use NANI offline?

A downloaded on-device model can generate replies locally. Current balances, quotes, blockchain lookups and transaction submission require a connection.

How do I delete saved data?

The iPhone privacy choices guide explains local chat deletion, chat export, Watch history and in-app NANI account deletion. Public blockchain history remains public.

Where can I find the source?

See For builders for NANI’s open-source projects.

How do I get help?

Email support@nani.ooo ↗. The support guide explains what to include. Keep wallet secrets out of reports.