Getting started
Prerequisites
| Tool | Version |
|---|---|
| Flutter | 3.47.0-0.1.pre (beta channel) |
| Dart | matches Flutter SDK (pubspec.yaml) |
| Android SDK | API 26+, NDK as in android/app/build.gradle.kts |
| Device | Prefer arm64-v8a physical device (≥6 GB RAM for Gemma 4 E2B) |
On Windows, use PowerShell or Git Bash. For wireless ADB, keep a single device connection (adb devices).
Clone and install
git clone https://github.com/involvex/nova-assistant.git
cd nova-assistant
flutter pub get
Run
# List devices
flutter devices
# Run debug on Android
flutter run -d android
# Hot reload: r Hot restart: R
Build
flutter build apk --debug --target-platform android-arm64
flutter build apk --release
flutter build appbundle --release
Verify before committing
dart format --set-exit-if-changed .
flutter analyze --no-pub
flutter test
CI runs the same checks on every push to main.
First-run models
On first launch, use onboarding or Settings → AI Models to download or import a model:
- SmolLM / Gemma 3 1B — lighter soak testing (good for mid-range phones)
- Gemma 4 E2B — vision + thinking; needs significant free RAM
- Import —
.litertlmor.taskfrom storage (GGUF is blocked)
Optional: set a HuggingFace token in Settings for authenticated downloads. Optional: enable Adult mode in Settings if you want less prudish answers on legal adult topics (on-device only; still refuses illegal content).
Agent-assisted setup
Open the repo in Cursor (or another agent) and ask:
use the nova_dev skill to setup and build the app