- Android 10+ (minSdk 29), target/compile SDK 35 - chat.n1ko.dev only; other links open in the system browser - system file picker for attachments, DownloadManager for files - TLS never bypassed, no cleartext, no analytics - pull-to-refresh, back navigation, progress and retry screen
2.2 KiB
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.
- 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.devloads 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.
Install
Download the APK from the releases page and open it on the phone (allow installing apps from this source when Android asks). The APK is debug-signed for now, so Android may show a warning.
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 # unsigned; sign it yourself
Or just open the project in Android Studio.
Release signing
Create a keystore and export it as Gradle properties or use
apksigner on the release output:
keytool -genkeypair -v -keystore nikogpt.jks -alias nikogpt \
-keyalg RSA -keysize 2048 -validity 10000
apksigner sign --ks nikogpt.jks --out nikogpt-release.apk \
app/build/outputs/apk/release/app-release-unsigned.apk
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).