# Help a user install Manina AI firmware

Use this guide when the user explicitly asks for help setting up Manina AI. The installation page is https://manina.ai/install. Help the user understand the page, check their equipment, and resolve connection problems. The user chooses the USB device and confirms installation.

## What the user needs

- A standard Seeed Studio XIAO ESP32S3 with 8 MB flash and 8 MB PSRAM. This installer does not support the Sense, Plus, or other ESP32 boards.
- A computer running desktop Chrome or Edge.
- A USB cable that carries data. A charging-only cable will not work.

An iPhone or Safari cannot perform this installation. The computer is needed for this setup step; afterward, the board works directly with the iPhone and Manina AI app. This flow does not require compiling code, Arduino, OTA, browser extensions, or an account login.

## Install from the webpage

1. Ask the user to connect the board to their computer, then open https://manina.ai/install in Chrome or Edge.
2. Read the page's actual release status. Proceed only when it offers a compatible stable firmware release. If firmware has not been published, stop and explain that installation is unavailable. Do not keep trying alternative downloads. If the release check fails, use **Check again** or try later.
3. Explain that installation replaces the firmware and data currently on the board. If the user needs that content, they should preserve it before continuing.
4. Have the user click **Connect board** and select their board in the browser's USB device chooser. The user must make this selection themselves.
5. Let the user click Connect board and pick the board in the browser's list. If the page says the board is restarting into install mode, click Connect board again. Keep the board connected and the page open while it erases, writes and verifies the firmware (about half a minute).
6. Confirm success from the page itself: the heading changes to "Installed." An animation, elapsed time, or this guide is not evidence of success. After confirmed completion, tell the user to unplug the board from the computer, plug it into their iPhone, and open Manina AI for the remaining setup.

## Chinese page

The same installer is available in Simplified Chinese at https://manina.ai/zh/install. There the button is **连接板子** (Connect board), **再检查一次** is Check again, and success shows the heading "安装完成。" (Installed.).

## If the board is missing

Check the data cable and close other applications using the serial port. If necessary, hold **BOOT** while reconnecting the board, release it, and try **Connect board** again.

## Firmware source

The webpage uses a same-origin manifest for the fixed release attachment `handsy-xiao-esp32s3.factory.bin`. Do not substitute arbitrary binary files. The legacy `v0.1.0` release is incompatible with this setup.
