Rikkahub Revised

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

English | Simplified Chinese

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.

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.

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

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.

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

• Added model-aware request parameters for OpenAI, Claude, Gemini, Grok, Qwen, and DeepSeek, plus sanitized diagnostics that omit credentials, prompts, schemas, and binary content.

• Added premature stream termination detection, corrected retry time budgets, and improved event-stream keepalive behavior.

• Added Gemini image-generation controls and unified source, inline, and full-screen previews for supported rich code blocks.

• Fixed crop cleanup before persistence completed, conversation switching after repeated settings changes, non-atomic navigation replacement, and misplaced provider model actions.

• Token-aware rolling context summaries, automatic context-window discovery, animated compression feedback, and context usage display.

• Local knowledge bases with document ingestion, chunking, hybrid retrieval, assistant bindings, RAG, source citations, and file previews.

• Expanded memory metadata, embedding-based retrieval, lexical fallback, and scoped memory tools.

• Provider capability metadata, embedding support, connection diagnostics, sanitized protocol traces, maximum reasoning controls with provider-specific parameter mapping, and safer custom-provider configuration handling.

• Tighter approval and privacy boundaries for workspace, clipboard, calendar, and screen-time tools.

• Separated backup scopes and safer S3/WebDAV archive restoration.

• Day-based cleanup for chat attachments and generated images while retaining conversation text.

• Interactive ECharts, ABC notation, Leaflet, and railroad-diagram rendering, plus Mermaid, LaTeX, Markdown, and WebView improvements.

• A Revised-owned update feed with ABI-aware APK selection.

• A separate application ID, isolated URI schemes and authorities, and opt-in Firebase integration.

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

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

• OpenAI-, Google-, and Anthropic-compatible providers and custom endpoints.
• Streaming chat, multimodal input, document parsing, and message branching.
• MCP, web search providers, prompt variables, tools, and assistant profiles.
• Markdown, syntax highlighting, LaTeX, tables, and Mermaid rendering.
• Local memory, provider import/export, an embedded web interface, and the optional Linux workspace environment.

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

Prerequisites:

• JDK 17
• Android SDK with API 37 and Build Tools 37
• Git with submodule support

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.

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.

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.

• NOTICE identifies the upstream project and the Revised distribution.
• MODIFICATIONS.md records the material modifications.
• CONTRIBUTORS.md lists the people who directly build and maintain this independent repository.
• THIRD_PARTY_NOTICES.md lists bundled third-party components and their licenses.
• RELEASE_SIGNING.md records the public signing identity and release-key continuity requirements.

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