Skip to main content

​
Official sources

On every platform, installation is currently done by building from source. Follow the platform guide to prepare the build tools.

​
Get the app source

After installing Git, run in a terminal:
The repository contains four platform directories: macos/, windows/, ios/, and android/. Keep the full repository structure, because some platforms rely on shared files in other directories.

​
Prepare the model by platform

The model file formats differ by platform and are not interchangeable. Use the files prepared according to the matching platform guide.

​
Before you download

  1. Confirm your device meets the Device Requirements.
  2. Decide between 8B and 35B; for a first try, 8B is recommended.
  3. Obtain models only from the official sources above.
  4. Keep a network connection during the download and the first build.
  5. Complete all conversion, packaging, and verification steps in the platform guide.
For model specifications and sizes, see Models: 8B vs 35B.

​
First load

A model must be activated before you can chat. On macOS, click Load model. On Windows, conversion starts automatically after the download finishes; then click Enable. On iOS, bundle the model into the project before building. On Android, import the model to the device, tap Refresh, then tap Load. The first load and the first turn may take longer. Once the model is ready, send a short message to confirm you can get a reply. For an example, see Quick Start. If a download, conversion, or load fails, note the error message shown in the interface, then see Troubleshooting.