explaingit

rikkahub/rikkahub

4,530KotlinAudience · vibe coderComplexity · 2/5Setup · easy

TLDR

An Android app that lets you chat with multiple AI services using your own API key, supporting text, images, PDFs, and conversation branching without locking you into one provider.

Mindmap

mindmap
  root((rikkahub))
    What it does
      AI chat on Android
      Multi-provider support
      Message branching
    Tech Stack
      Kotlin
      Jetpack Compose
      Material You
    Features
      Web search
      AI translation
      Memory
      Custom agents
    Inputs
      Text and images
      PDFs
      Word documents
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Chat with any OpenAI-compatible AI service on Android by entering your own API key

USE CASE 2

Send images or PDFs in a conversation and get AI responses with code, math, and diagram formatting

USE CASE 3

Fork a conversation at any point to explore different directions without losing your original thread

USE CASE 4

Use built-in web search and AI translation within the same app session

Tech stack

KotlinJetpack ComposeMaterial YouAndroid

Getting it running

Difficulty · easy Time to first run · 5min

Requires your own API key from an OpenAI-compatible, Google, or Anthropic AI provider.

In plain English

RikkaHub is an Android app for chatting with AI language models. Rather than locking you into one provider, it lets you connect to different AI services by entering your own API key and server address. It works with any API that follows the formats used by OpenAI, Google, or Anthropic, which covers a wide range of AI services. The app supports sending text, images, PDFs, and Word documents in a conversation. It renders responses with code highlighting, math formulas, tables, and diagrams using a format called Mermaid. There is a message branching feature, which means you can fork a conversation at any point to try different directions. The app also supports web search through several different search providers and includes an AI translation feature. Other features listed in the README include memory (similar to how ChatGPT remembers things about you across conversations), custom AI agents you can configure yourself, the ability to import character cards from a platform called Silly Tavern, and QR code-based import and export for sharing your provider settings. There is also support for a standard called MCP, which is a protocol for AI tools to call external services. The interface uses Android's Material You design system, which means the app's colors adapt to your phone's wallpaper, and it supports dark mode. It is built with Kotlin and Jetpack Compose. The app is available on Google Play and through the project's own website. The maintainer notes that pull requests for new features, translations, or large AI-generated refactors will be rejected, as the project follows a specific vision.

Copy-paste prompts

Prompt 1
I want to connect RikkaHub to my Claude API key on Android. What steps do I follow to add a new provider with a custom server address?
Prompt 2
How do I import conversation settings from another device in RikkaHub using the QR code feature?
Prompt 3
Walk me through setting up a custom AI agent in RikkaHub with its own system prompt and persona
Prompt 4
How does message branching work in RikkaHub, show me when I would use it and how to navigate between branches
Prompt 5
How do I enable MCP in RikkaHub to connect external tools to my AI conversations?
Open on GitHub → Explain another repo

← rikkahub on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.