---
verifiedAt: '2026-08-22'
---

# RikkaHub Guide

`RikkaHub` is an Android AI chat client that supports multiple OpenAI-compatible interfaces, suitable for daily AI conversations on mobile devices.

## Installation

RikkaHub currently supports Android only and **does not support iOS**.

You can install it with either method:

- Download the APK from the [RikkaHub download page](https://rikka-ai.com/download) and install it manually.
- Search for `RikkaHub` on Google Play and install it.

## Connect to Flux

RikkaHub can connect to Flux through its OpenAI-compatible provider support.

1. Follow [Create API Key](https://docs.tryflux.net/en/docs/flux/create-apikey.md) to generate an API key.
2. Open `RikkaHub`, tap the left **sidebar**, and go to **Settings**.
3. Choose **Providers**, add a new provider, and select `OpenAI` as the type.
4. Fill in the following configuration:

   ```text
   Provider type: OpenAI
   Base URL: https://api.tryflux.net/v1
   API Key: Flux API key
   ```

   > **Note:** The Base URL must end with `/v1`. RikkaHub appends paths such as `/chat/completions` automatically, so do not add duplicate path segments at the end.

5. Save the provider, wait for the model list to refresh, then tap the icon on the **left** of Add Model and choose target models.
6. Return to the home page and select the model you just added to start chatting.

## Verify the Setup

Whether the model list refreshes in step 5 is the most direct check: models appearing means the API key and base URL are both correct.

Then send a message in the chat interface. A reply means the setup works, and the call appears in the [usage logs](https://tryflux.net/usage).

If the model list does not refresh, rule the client out with [Test the Key and Endpoint on Their Own](https://docs.tryflux.net/en/docs/troubleshooting.md#test-the-key-and-endpoint-on-their-own), then check that the base URL ends with `/v1` and does not repeat the path.

## Next Steps

After completing configuration, you can start model conversations directly in `RikkaHub`.

<!--
## Image Generation

> Prerequisite: You have completed Flux setup above and imported a model that supports image generation.

1. Go to **Settings -> Providers**, find the imported image-generation model, and change its **type** to **Image**.

   <div style="text-align: center;">
     <img src="https://docs.tryflux.net/images/rikkahub/step-1-edit-model-type.png" alt="RikkaHub setting an image-generation model type to Image" />
   </div>

2. Return to the home page, tap the left **sidebar**, find **Image Generation** at the bottom, and open it.

   <div style="text-align: center;">
     <img src="https://docs.tryflux.net/images/rikkahub/step-2-image-settings.png" alt="RikkaHub image generation entry at the bottom of the sidebar" />
   </div>

3. Select the configured model on the image-generation page and start generating images.

   <div style="text-align: center;">
     <img src="https://docs.tryflux.net/images/rikkahub/step-3-select-model.png" alt="RikkaHub selecting a model on the image generation page" />
   </div>
-->

## More Related Content

- [Balance and Billing](https://docs.tryflux.net/en/docs/flux/billing.md)