Rikkahub-Revised README

The project's README from github.com/YaeNovin/Rikkahub-Revised. As one markdown file: README.md.

Rikkahub Revised app icon

Rikkahub Revised

An independent, community-maintained Android AI chat client based on RikkaHub.

English | Simplified Chinese

Latest release License: AGPL-3.0 Android 8.0+ Powered by OrcaRouter

[!IMPORTANT] Rikkahub Revised is a modified distribution of RikkaHub. It is not an official RikkaHub release and is not endorsed or supported by the upstream maintainers. Revised-specific issues should be reported in this repository, not to the upstream project.

Project Identity

This repository contains the complete source for Rikkahub Revised. The current release line is based on upstream RikkaHub 2.4.8 at commit 8824e0e8. Later upstream releases are not automatically included.

Item Value
Distribution name Rikkahub Revised
Android application ID me.rerere.rikkahub.revised
Current release 2.4.8-revised.7
Minimum Android version Android 8.0 (API 26)
Source repository YaeNovin/Rikkahub-Revised
License GNU Affero General Public License v3.0

The distinct application ID allows Rikkahub Revised and upstream RikkaHub to be installed on the same device. Their app data is separate, and this project does not automatically import data from the upstream application.

Download

Official Rikkahub Revised APKs are published only through this repository's GitHub Releases.

APK Intended devices
app-arm64-v8a-release.apk Most modern Android phones and tablets
app-x86_64-release.apk x86_64 emulators and compatible devices
app-universal-release.apk Universal fallback containing ARM64 and x86_64 native libraries

Release asset filenames may include the release version suffix. For example, the current .7 release publishes app-arm64-v8a-release-2.4.8-revised.7.apk; the updater detects the device ABI from the asset name.

The in-app updater reads the latest public release from this repository and offers an APK compatible with the device ABI. Release descriptions contain only user-facing updates and fixes; package integrity and signing continuity are verified separately during publication.

All future Revised releases must use the same signing certificate. Builds signed with another key cannot update an existing Rikkahub Revised installation. See RELEASE_SIGNING.md for the public certificate record and signing continuity policy. Private signing material is never stored in this repository.

Provider Promotion

Notice: The providers below are listed for promotion only. They are third-party providers and are not affiliated with this project.

Provider Overview
OrcaRouter Asia's largest large-model API gateway, offering secure inference with zero markup. Pay-as-you-go and subscription plans are available, and free models are provided for long-term use alongside paid models. Intelligent routing, secure deployment, and lower costs.

What Revised Changes

Rikkahub Revised keeps the upstream Android client as its foundation and adds or changes the following areas:

Current Formal Release: 2.4.8-revised.7

For the auditable modification record, upstream comparison, and release requirements, read MODIFICATIONS.md.

Inherited Capabilities

The upstream foundation provides the core Android chat experience, including:

These inherited capabilities originate from the upstream project unless a change is identified in MODIFICATIONS.md.

Build From Source

Prerequisites:

Clone the complete source and initialize its submodule:

git clone --recurse-submodules https://github.com/YaeNovin/Rikkahub-Revised.git
cd Rikkahub-Revised

Build a development APK on Windows:

.\gradlew.bat :app:assembleDebug

On Linux or macOS:

./gradlew :app:assembleDebug

Run JVM tests with ./gradlew test or gradlew.bat test. The Android app is the app module; the remaining modules and common change locations are mapped in docs/PROJECT_STRUCTURE.md.

The chat request lifecycle is documented separately in English and Simplified Chinese.

Release builds read signing values from the ignored local local.properties. Do not commit keystores, passwords, local.properties, or a Firebase configuration. Firebase and Crashlytics are disabled by default; a maintainer-owned configuration matching the Revised application ID is required to opt in.

Contributing and Support

Bug reports and changes for Rikkahub Revised are welcome through this repository's issues and pull requests. Please state whether a problem also occurs in upstream RikkaHub and avoid including provider keys, account data, signing files, or private chat content in reports.

Upstream documentation and community channels belong to the upstream project. They should not be treated as support channels for Revised-only behavior.

License and Attribution

Rikkahub Revised is distributed under the GNU Affero General Public License v3.0, consistent with its upstream foundation. When distributing modified versions or providing the software over a network, comply with the AGPL-3.0 source-availability requirements.

Copyright and authorship of unchanged upstream code remain with the upstream contributors. This repository does not claim authorship of that work.

Rikkahub-Revised (YaeNovin/Rikkahub-Revised)

Searching Database…

What is this?Rikkahub Revised is an Android AI chat client for talking to LLM providers - an independent, community-maintained modified distribution of RikkaHub, currently at release 2.4.8-revised.7.
Is this the official RikkaHub app or a fork?A fork: it is not official and not endorsed by the upstream maintainers. It ships with its own application ID, so it installs alongside upstream RikkaHub on the same device, with separate data and no automatic import from the upstream app.
How do I install it on my phone?Download an APK from this repository's GitHub Releases - arm64-v8a for most modern phones, x86_64 for emulators, or a universal build. After that, the built-in updater detects your device ABI and offers matching updates.
Does it come with a built-in AI service, or do I connect my own providers?You connect your own - it works with OpenAI-, Google-, and Anthropic-compatible providers and custom endpoints, with model-aware parameters for OpenAI, Claude, Gemini, Grok, Qwen, and DeepSeek. The listed OrcaRouter gateway is paid promotion only, not affiliated with the project.
Will it automatically pick up new upstream RikkaHub releases?No. This release line is based on upstream 2.4.8 (commit 8824e0e8), and later upstream releases are not automatically included. Updates also require the project's own signing key - an APK signed with a different key cannot update an existing install.
Which Android version does it need?Android 8.0 (API 26) or newer. Release APKs cover ARM64 phones and tablets, x86_64 emulators, plus a universal fallback containing both native library sets.
Does everything stay on my phone?Knowledge bases and assistant memory are stored locally, and diagnostics are sanitized to omit credentials, prompts, schemas, and binary content. Sensitive tools (workspace, clipboard, calendar, screen time) sit behind approval boundaries, and Firebase only enables if you opt in.
Is there anything unusual about the license?It is AGPL-3.0, same as upstream: if you distribute modified versions or serve the app over a network, you must make the corresponding source available. Standard AGPL copyleft - worth knowing before forking.
What can it do inside a chat beyond plain text?Streaming chat with multimodal input, document parsing, and message branching; MCP tools, web search providers, prompt variables, and assistant profiles. It renders Markdown, LaTeX, tables, and Mermaid, plus interactive ECharts, ABC notation, and Leaflet maps.
Does it have local knowledge bases or RAG?Yes: documents are ingested, chunked, and retrieved with hybrid search, assistants can be bound to a knowledge base, and answers come with source citations and file previews. Assistant memory retrieval is embedding-based with a lexical fallback.
Can it generate images?Yes. Revised adds image-generation settings with full-screen previews and Gemini image-generation controls; what you can actually generate depends on the provider and model you configure.
Creator
YaeNovin
Size
62.3 MB
Stars
218
Age
2mo
Commits · 90 Days