build / apk (push) Has been cancelled

Details

"Share to NikoGPT" now accepts any file type (single or multiple): the
stream is read through the content resolver and pushed into the web
composer as base64 chunks, so photos and documents land next to the
keyboard ready to send. Oversized files are refused with a clear
message (the chat takes up to 16 MB).

2026-10-19 08:30:39 +03:00

3.5 KiB

Raw Permalink Blame History

NikoGPT for Android

Open-source Android client for the NikoGPT web chat (chat.n1ko.dev) — a thin, auditable WebView shell around the same web interface that runs in the browser. No analytics, no trackers, no third-party SDKs: the whole app is one activity and a handful of resources.

Android 10+ (minSdk 29), targets Android 15.
Everything the web app can do: conversations, attachments (system file picker), images, generated files, settings, themes.
Share anything to NikoGPT: from another app share text or any file (photos, PDFs, audio, archives…) straight into the composer.
Downloads go through Android's DownloadManager (with your session cookies), links to other sites open in the system browser.
Open in the browser only: chat.n1ko.dev loads inside; anything else leaves the app.
TLS errors are never bypassed, no cleartext traffic, no backup.
Day/night theme follows the system; the page keeps its own theme setting.
Back gesture navigates the chat history; pull-to-refresh reloads only at the very top of the chat — never inside a presentation, a dialog or another list.

Install

Download the APK from the releases page: https://git.n1ko.dev/Niko/nikogpt_android/releases

Latest build: https://git.n1ko.dev/Niko/nikogpt_android/releases/download/v1.3.0/nikogpt-android-1.3.0.apk

Open the APK on the phone (allow installing apps from this source when Android asks). The APKs are signed with the project's release key; Android may still warn because the app is installed from outside Play.

Build

Requirements: JDK 17, Android SDK (platform 35, build-tools 35.0.0).

./gradlew assembleDebug     # app/build/outputs/apk/debug/app-debug.apk
./gradlew assembleRelease   # release; signed with the keystore when configured

Or just open the project in Android Studio.

Release signing

The published APKs are signed with the project's release keystore (keystore.properties + the .jks file, both outside git). To build them yourself, create a keystore and point keystore.properties at it:

keytool -genkeypair -v -keystore nikogpt.jks -alias nikogpt \
  -keyalg RSA -keysize 2048 -validity 10000
cat > keystore.properties <<EOF
storeFile=../nikogpt.jks
storePassword=...
keyAlias=nikogpt
keyPassword=...
EOF
./gradlew assembleRelease

Installing over a debug-signed build requires uninstalling it first (the signatures differ). The release certificate's SHA-256 must be listed in web.android_cert_sha256 in the bot config for App Links verification.

All credentials live on NikoAuth (auth.n1ko.dev): password, e-mail codes, 2FA and Google. The app opens the login in the system browser — Google refuses WebView logins, and a WebView never shares the browser's cookie jar — and comes back through a verified App Link (https://chat.n1ko.dev/app-auth?...) once the login is done; the server hands the fresh session to the app's WebView on that link. Requires the release certificate's SHA-256 in the bot's web.android_cert_sha256 for App Links verification.

Structure

Path	Purpose
`app/src/main/java/dev/n1ko/nikogpt/MainActivity.kt`	the whole app: WebView setup, file chooser, downloads, back handling
`app/src/main/res/layout/activity_main.xml`	WebView + progress bar + retry screen
`.forgejo/workflows/build.yml`	CI: builds the APK on tags

License

MIT — see LICENSE. The Tabler-based icons used by the web chat come from f.n1ko.dev/assets/ui (MIT).

3.5 KiB Raw Permalink Blame History