From d08d192188673553ae12882e172b5e4558e0faa0 Mon Sep 17 00:00:00 2001
From: JamTheDev <2004jamvillarosa@gmail.com>
Date: Mon, 11 May 2026 14:11:24 +0800
Subject: [PATCH 1/5] feat: bootstrap web flutter_gemma

---
 .../datasources/flutter_gemma_bootstrap.dart  | 14 ++++++++
 .../datasources/gemma_model_file_type.dart    | 14 ++++++++
 .../datasources/local_gemma_datasource.dart   | 34 +++++++++++--------
 lib/main.dart                                 | 11 ++----
 web/index.html                                |  8 +++++
 5 files changed, 58 insertions(+), 23 deletions(-)
 create mode 100644 lib/features/translator/data/datasources/flutter_gemma_bootstrap.dart
 create mode 100644 lib/features/translator/data/datasources/gemma_model_file_type.dart

diff --git a/lib/features/translator/data/datasources/flutter_gemma_bootstrap.dart b/lib/features/translator/data/datasources/flutter_gemma_bootstrap.dart
new file mode 100644
index 0000000..f9c5ff6
--- /dev/null
+++ b/lib/features/translator/data/datasources/flutter_gemma_bootstrap.dart
@@ -0,0 +1,14 @@
+import 'package:flutter/foundation.dart';
+import 'package:flutter_gemma/core/api/flutter_gemma.dart';
+import 'package:flutter_gemma/core/domain/web_storage_mode.dart';
+
+Future<void> initializeFlutterGemma({String? huggingFaceToken}) async {
+  final String? normalizedToken = huggingFaceToken?.trim().isEmpty ?? true
+      ? null
+      : huggingFaceToken?.trim();
+
+  await FlutterGemma.initialize(
+    huggingFaceToken: normalizedToken,
+    webStorageMode: kIsWeb ? WebStorageMode.streaming : WebStorageMode.cacheApi,
+  );
+}
diff --git a/lib/features/translator/data/datasources/gemma_model_file_type.dart b/lib/features/translator/data/datasources/gemma_model_file_type.dart
new file mode 100644
index 0000000..9f0945e
--- /dev/null
+++ b/lib/features/translator/data/datasources/gemma_model_file_type.dart
@@ -0,0 +1,14 @@
+import 'package:flutter_gemma/flutter_gemma.dart';
+
+ModelFileType resolveGemmaModelFileType(String modelUrl) {
+  final Uri uri = Uri.parse(modelUrl);
+  final String fileName = uri.pathSegments.isEmpty
+      ? modelUrl
+      : uri.pathSegments.last;
+  final String lower = fileName.toLowerCase();
+
+  if (lower.endsWith('.litertlm')) {
+    return ModelFileType.litertlm;
+  }
+  return ModelFileType.task;
+}
diff --git a/lib/features/translator/data/datasources/local_gemma_datasource.dart b/lib/features/translator/data/datasources/local_gemma_datasource.dart
index 72f5d28..8e8632d 100644
--- a/lib/features/translator/data/datasources/local_gemma_datasource.dart
+++ b/lib/features/translator/data/datasources/local_gemma_datasource.dart
@@ -4,6 +4,7 @@ import 'package:flutter_gemma/flutter_gemma.dart';
 
 import 'package:kudlit_ph/core/error/exceptions.dart';
 import 'package:kudlit_ph/features/translator/data/datasources/ai_datasource.dart';
+import 'package:kudlit_ph/features/translator/data/datasources/gemma_model_file_type.dart';
 import 'package:kudlit_ph/features/translator/domain/entities/baybayin_challenge.dart';
 import 'package:kudlit_ph/features/translator/domain/entities/chat_message.dart';
 import 'package:kudlit_ph/features/translator/domain/entities/gemma_model_info.dart';
@@ -16,7 +17,6 @@ import 'package:kudlit_ph/features/translator/domain/entities/gemma_model_info.d
 /// - iOS: `flutter_gemma` uses `NSURLSession` which schedules the
 ///   download discretionarily — iOS picks the timing, the app may
 ///   be backgrounded or terminated while download proceeds.
-/// - Web: not supported by this datasource (`kIsWeb` guard upstream).
 class LocalGemmaDatasource implements AiDatasource {
   LocalGemmaDatasource();
 
@@ -32,7 +32,9 @@ class LocalGemmaDatasource implements AiDatasource {
   Future<LocalGemmaReadiness> probeReadiness(GemmaModelInfo model) {
     // Fast path: model is already loaded — skip all native work.
     if (_activeModel != null) {
-      debugPrint('[Gemma][local] readiness probe fast-path (model already loaded)');
+      debugPrint(
+        '[Gemma][local] readiness probe fast-path (model already loaded)',
+      );
       return Future<LocalGemmaReadiness>.value(
         LocalGemmaReadiness(
           installed: true,
@@ -97,7 +99,7 @@ class LocalGemmaDatasource implements AiDatasource {
   /// Ensures the model is loaded into memory without blocking inference.
   /// Safe to call fire-and-forget after download completes.
   Future<void> ensureModelLoaded() async {
-    if (kIsWeb || _activeModel != null) return;
+    if (_activeModel != null) return;
     try {
       _activeModel = await FlutterGemma.getActiveModel();
       _activeModelHasVision = false;
@@ -127,7 +129,7 @@ class LocalGemmaDatasource implements AiDatasource {
       final InferenceInstallationBuilder builder =
           FlutterGemma.installModel(
                 modelType: ModelType.gemma4,
-                fileType: _modelFileTypeFor(model),
+                fileType: resolveGemmaModelFileType(model.modelLink),
               )
               .fromNetwork(model.modelLink, token: hfToken)
               .withCancelToken(_cancelToken!);
@@ -205,9 +207,16 @@ class LocalGemmaDatasource implements AiDatasource {
     String mimeType = 'image/png',
     String? prompt,
   }) async* {
+    if (kIsWeb) {
+      throw UnsupportedError(
+        'Image analysis is not supported by flutter_gemma on web yet.',
+      );
+    }
     InferenceChat? imageChat;
     try {
-      debugPrint('[Gemma][local] analyzeImage called | bytes=${imageBytes.length}');
+      debugPrint(
+        '[Gemma][local] analyzeImage called | bytes=${imageBytes.length}',
+      );
       // Close any active text chat — native model allows one session at a time.
       if (_chat != null) {
         await _chat!.close();
@@ -242,7 +251,10 @@ class LocalGemmaDatasource implements AiDatasource {
       debugPrint('[Gemma][local] analyzeImage stream finished');
     } catch (e, s) {
       debugPrint('[Gemma][local] analyzeImage error: $e');
-      debugPrintStack(stackTrace: s, label: '[Gemma][local] analyzeImage stack');
+      debugPrintStack(
+        stackTrace: s,
+        label: '[Gemma][local] analyzeImage stack',
+      );
       rethrow;
     } finally {
       await imageChat?.close();
@@ -261,19 +273,11 @@ class LocalGemmaDatasource implements AiDatasource {
     final String? hfToken = dotenv.env['HUGGINGFACE_TOKEN'];
     await FlutterGemma.installModel(
       modelType: ModelType.gemma4,
-      fileType: _modelFileTypeFor(model),
+      fileType: resolveGemmaModelFileType(model.modelLink),
     ).fromNetwork(model.modelLink, token: hfToken).install();
     debugPrint('[Gemma][local] active model restored for ${model.fileName}');
   }
 
-  ModelFileType _modelFileTypeFor(GemmaModelInfo model) {
-    final String lower = model.fileName.toLowerCase();
-    if (lower.endsWith('.litertlm')) {
-      return ModelFileType.litertlm;
-    }
-    return ModelFileType.task;
-  }
-
   @override
   Future<void> dispose() async {
     await _activeModel?.close();
diff --git a/lib/main.dart b/lib/main.dart
index 2374c9f..347b62d 100644
--- a/lib/main.dart
+++ b/lib/main.dart
@@ -1,12 +1,11 @@
-import 'package:flutter/foundation.dart';
 import 'package:flutter/material.dart';
 import 'package:flutter_dotenv/flutter_dotenv.dart';
-import 'package:flutter_gemma/core/api/flutter_gemma.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:supabase_flutter/supabase_flutter.dart';
 
 import 'package:kudlit_ph/app/app.dart';
 import 'package:kudlit_ph/core/config/supabase_config.dart';
+import 'package:kudlit_ph/features/translator/data/datasources/flutter_gemma_bootstrap.dart';
 
 Future<void> main() async {
   WidgetsFlutterBinding.ensureInitialized();
@@ -15,11 +14,7 @@ Future<void> main() async {
     url: SupabaseConfig.url,
     anonKey: SupabaseConfig.anonKey,
   );
-  if (!kIsWeb) {
-    final String hfToken = dotenv.env['HUGGINGFACE_TOKEN'] ?? '';
-    await FlutterGemma.initialize(
-      huggingFaceToken: hfToken.isEmpty ? null : hfToken,
-    );
-  }
+  final String hfToken = dotenv.env['HUGGINGFACE_TOKEN'] ?? '';
+  await initializeFlutterGemma(huggingFaceToken: hfToken);
   runApp(const ProviderScope(child: KudlitApp()));
 }
diff --git a/web/index.html b/web/index.html
index f4cd097..e1be68a 100644
--- a/web/index.html
+++ b/web/index.html
@@ -43,6 +43,14 @@
 
   <title>Kudlit App - Baybayin Scanner, Translator, and Learning Companion</title>
   <link rel="manifest" href="manifest.json">
+  <script type="module">
+    import {
+      FilesetResolver,
+      LlmInference
+    } from 'https://cdn.jsdelivr.net/npm/@mediapipe/tasks-genai@0.10.27';
+    window.FilesetResolver = FilesetResolver;
+    window.LlmInference = LlmInference;
+  </script>
 </head>
 <body>
   <!--

From 5822e7c23c46670a32015196116ce67615891eea Mon Sep 17 00:00:00 2001
From: JamTheDev <2004jamvillarosa@gmail.com>
Date: Mon, 11 May 2026 14:11:24 +0800
Subject: [PATCH 2/5] feat: enable web local gemma

---
 .../providers/model_setup_controller.dart     | 129 ++++----
 .../providers/translate_text_controller.dart  |   2 +-
 .../screens/model_setup_screen.dart           |   9 +-
 .../widgets/settings/llm_download_tile.dart   | 291 +++++++++---------
 .../ai_inference_repository_impl.dart         |  18 +-
 5 files changed, 215 insertions(+), 234 deletions(-)

diff --git a/lib/features/home/presentation/providers/model_setup_controller.dart b/lib/features/home/presentation/providers/model_setup_controller.dart
index 937437a..25cea22 100644
--- a/lib/features/home/presentation/providers/model_setup_controller.dart
+++ b/lib/features/home/presentation/providers/model_setup_controller.dart
@@ -5,9 +5,9 @@ import 'package:flutter_riverpod/flutter_riverpod.dart';
 
 import 'package:kudlit_ph/features/home/presentation/providers/app_preferences_provider.dart';
 import 'package:kudlit_ph/features/scanner/presentation/providers/yolo_model_selection_provider.dart';
+import 'package:kudlit_ph/features/translator/data/datasources/local_gemma_datasource.dart';
 import 'package:kudlit_ph/features/translator/domain/entities/ai_model_info.dart';
 import 'package:kudlit_ph/features/translator/domain/entities/gemma_model_info.dart';
-import 'package:kudlit_ph/features/translator/data/datasources/local_gemma_datasource.dart';
 import 'package:kudlit_ph/features/translator/presentation/providers/ai_inference_provider.dart';
 import 'package:kudlit_ph/features/translator/presentation/providers/ai_inference_state.dart';
 import 'package:kudlit_ph/features/translator/presentation/providers/translator_providers.dart';
@@ -51,7 +51,7 @@ class ModelSetupController extends Notifier<ModelSetupState> {
     state = state.copyWith(busy: true, clearError: true);
 
     try {
-      final VisionModelSetupStatus visionStatus = await ref.read(
+      final VisionModelSetupStatus visionStatus = await ref.refresh(
         visionModelSetupStatusProvider.future,
       );
       if (!visionStatus.ready) {
@@ -59,30 +59,21 @@ class ModelSetupController extends Notifier<ModelSetupState> {
         return;
       }
 
-      final AppPreferences prefs = await ref.read(
-        appPreferencesNotifierProvider.future,
+      final LocalGemmaReadiness gemmaReadiness = await ref.refresh(
+        localModelReadinessProvider.future,
       );
-      final AiPreference nextPreference = kIsWeb
-          ? AiPreference.cloud
-          : prefs.aiPreference;
-
-      if (!kIsWeb && nextPreference == AiPreference.local) {
-        final LocalGemmaReadiness gemmaReadiness = await ref.read(
-          localModelReadinessProvider.future,
+      if (!gemmaReadiness.installed || !gemmaReadiness.usable) {
+        state = state.copyWith(
+          busy: false,
+          errorMessage:
+              'Download the Gemma model before continuing with offline AI.',
         );
-        if (!gemmaReadiness.installed || !gemmaReadiness.usable) {
-          state = state.copyWith(
-            busy: false,
-            errorMessage:
-                'Download the Gemma model before continuing with offline AI.',
-          );
-          return;
-        }
+        return;
       }
 
       await ref
           .read(appPreferencesNotifierProvider.notifier)
-          .setAiPreference(nextPreference);
+          .setAiPreference(AiPreference.local);
       await ref
           .read(appPreferencesNotifierProvider.notifier)
           .markModelsDownloaded();
@@ -99,31 +90,6 @@ class ModelSetupController extends Notifier<ModelSetupState> {
 
     state = state.copyWith(busy: true, clearError: true);
 
-    if (kIsWeb) {
-      try {
-        final VisionModelSetupStatus visionStatus = await ref.refresh(
-          visionModelSetupStatusProvider.future,
-        );
-        if (!visionStatus.ready) {
-          state = state.copyWith(
-            busy: false,
-            errorMessage: visionStatus.message,
-          );
-          return;
-        }
-        await ref
-            .read(appPreferencesNotifierProvider.notifier)
-            .setAiPreference(AiPreference.cloud);
-        await ref
-            .read(appPreferencesNotifierProvider.notifier)
-            .markModelsDownloaded();
-        state = state.copyWith(busy: false, clearError: true);
-      } catch (e) {
-        state = state.copyWith(busy: false, errorMessage: e.toString());
-      }
-      return;
-    }
-
     await ref
         .read(aiInferenceNotifierProvider.notifier)
         .triggerLocalDownload(llmModel);
@@ -137,40 +103,53 @@ class ModelSetupController extends Notifier<ModelSetupState> {
     }
 
     try {
-      final List<AiModelInfo> visionModels = await ref.read(
-        availableYoloModelsProvider.future,
-      );
-      final AiModelInfo? visionModel = visionModels.isEmpty
-          ? null
-          : visionModels.first;
-      if (visionModel == null) {
-        state = state.copyWith(
-          busy: false,
-          errorMessage: 'No scanner model is configured yet.',
+      if (kIsWeb) {
+        final VisionModelSetupStatus visionStatus = await ref.refresh(
+          visionModelSetupStatusProvider.future,
         );
-        return;
-      }
+        if (!visionStatus.ready) {
+          state = state.copyWith(
+            busy: false,
+            errorMessage: visionStatus.message,
+          );
+          return;
+        }
+      } else {
+        final List<AiModelInfo> visionModels = await ref.read(
+          availableYoloModelsProvider.future,
+        );
+        final AiModelInfo? visionModel = visionModels.isEmpty
+            ? null
+            : visionModels.first;
+        if (visionModel == null) {
+          state = state.copyWith(
+            busy: false,
+            errorMessage: 'No scanner model is configured yet.',
+          );
+          return;
+        }
 
-      final String yoloUrl = resolveYoloModelUrl(visionModel);
-      if (yoloUrl.isEmpty) {
-        state = state.copyWith(
-          busy: false,
-          errorMessage:
-              'The selected scanner model does not have a download URL.',
+        final String yoloUrl = resolveYoloModelUrl(visionModel);
+        if (yoloUrl.isEmpty) {
+          state = state.copyWith(
+            busy: false,
+            errorMessage:
+                'The selected scanner model does not have a download URL.',
+          );
+          return;
+        }
+
+        await ref
+            .read(yoloModelCacheProvider)
+            .download(visionModel.id, yoloUrl, version: visionModel.version);
+        ref.invalidate(visionModelSetupStatusProvider);
+        ref.invalidate(yoloModelPathProvider);
+        unawaited(
+          ref
+              .read(yoloModelPathProvider(YoloModelScope.camera).future)
+              .catchError((Object _) => ''),
         );
-        return;
       }
-
-      await ref
-          .read(yoloModelCacheProvider)
-          .download(visionModel.id, yoloUrl, version: visionModel.version);
-      ref.invalidate(visionModelSetupStatusProvider);
-      ref.invalidate(yoloModelPathProvider);
-      unawaited(
-        ref
-            .read(yoloModelPathProvider(YoloModelScope.camera).future)
-            .catchError((Object _) => ''),
-      );
     } catch (e) {
       debugPrint('[ModelSetup] YOLO download failed: $e');
       state = state.copyWith(
diff --git a/lib/features/home/presentation/providers/translate_text_controller.dart b/lib/features/home/presentation/providers/translate_text_controller.dart
index e02c3fa..12ecdf2 100644
--- a/lib/features/home/presentation/providers/translate_text_controller.dart
+++ b/lib/features/home/presentation/providers/translate_text_controller.dart
@@ -278,7 +278,7 @@ class TranslateTextController extends Notifier<TranslateTextState> {
         ref.read(appPreferencesNotifierProvider).value?.aiPreference ??
         AiPreference.cloud;
 
-    if (kIsWeb || mode == AiPreference.cloud) {
+    if (mode == AiPreference.cloud) {
       await _streamResponse(
         stream: ref
             .read(cloudGemmaDatasourceProvider)
diff --git a/lib/features/home/presentation/screens/model_setup_screen.dart b/lib/features/home/presentation/screens/model_setup_screen.dart
index 32e5576..a93d37c 100644
--- a/lib/features/home/presentation/screens/model_setup_screen.dart
+++ b/lib/features/home/presentation/screens/model_setup_screen.dart
@@ -378,8 +378,8 @@ class _SetupHeadline extends StatelessWidget {
         SizedBox(height: compact ? 8 : 10),
         Text(
           kIsWeb
-              ? 'Kudlit checks the browser scanner model here before you start. '
-                    'Gemma stays in cloud mode on web.'
+              ? 'Kudlit prepares both the browser scanner model and the '
+                    'browser Gemma model here before you start.'
               : 'Kudlit uses on-device AI models for Baybayin recognition '
                     'and translation — no internet needed once downloaded.',
           style: TextStyle(
@@ -422,8 +422,9 @@ class _DownloadNotice extends StatelessWidget {
           Expanded(
             child: Text(
               kIsWeb
-                  ? 'On web, the scanner model loads from Supabase Storage in '
-                        'the browser. Gemma continues to use cloud AI.'
+                  ? 'On web, both the scanner model and Gemma are loaded and '
+                        'stored by the browser. The first setup can take a '
+                        'while for large Gemma files.'
                   : 'AI model files are typically 1–5 GB. '
                         'Wi-Fi recommended. Download continues in the background.',
               style: TextStyle(
diff --git a/lib/features/home/presentation/widgets/settings/llm_download_tile.dart b/lib/features/home/presentation/widgets/settings/llm_download_tile.dart
index 35955e7..43a6eb9 100644
--- a/lib/features/home/presentation/widgets/settings/llm_download_tile.dart
+++ b/lib/features/home/presentation/widgets/settings/llm_download_tile.dart
@@ -2,9 +2,11 @@ import 'package:flutter/material.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 
 import 'package:kudlit_ph/features/home/presentation/providers/app_preferences_provider.dart';
+import 'package:kudlit_ph/features/translator/data/datasources/local_gemma_datasource.dart';
 import 'package:kudlit_ph/features/translator/domain/entities/gemma_model_info.dart';
 import 'package:kudlit_ph/features/translator/presentation/providers/ai_inference_provider.dart';
 import 'package:kudlit_ph/features/translator/presentation/providers/ai_inference_state.dart';
+import 'package:kudlit_ph/features/translator/presentation/providers/translator_providers.dart';
 
 import 'profile_management_action_button.dart';
 
@@ -23,6 +25,12 @@ class LlmDownloadTile extends ConsumerWidget {
     final AsyncValue<AiInferenceState> stateAsync = ref.watch(
       aiInferenceNotifierProvider,
     );
+    final AsyncValue<AppPreferences> prefsAsync = ref.watch(
+      appPreferencesNotifierProvider,
+    );
+    final AsyncValue<LocalGemmaReadiness> readinessAsync = ref.watch(
+      localModelReadinessProvider,
+    );
 
     return Padding(
       padding: const EdgeInsets.symmetric(horizontal: 16, vertical: 14),
@@ -32,19 +40,15 @@ class LlmDownloadTile extends ConsumerWidget {
           const _TileHeader(
             icon: Icons.psychology_rounded,
             label: 'Gemma 4 E2B',
-            sublabel: 'Offline Butty chat  ·  ~2.4 GB',
+            sublabel: 'Butty offline AI  ·  ~2.4 GB',
           ),
           const SizedBox(height: 10),
-          stateAsync.when(
-            loading: () => const _CheckingRow(),
-            error: (Object e, _) =>
-                _ErrRow(message: _friendlyLlmModelError(e.toString())),
-            data: (AiInferenceState s) => _LlmStatusRow(
-              state: s,
-              onDownload: notifier.downloadLocalModel,
-              onCancel: notifier.cancelDownload,
-              onTrigger: (GemmaModelInfo m) => notifier.triggerLocalDownload(m),
-            ),
+          _LlmStatusRow(
+            stateAsync: stateAsync,
+            prefsAsync: prefsAsync,
+            readinessAsync: readinessAsync,
+            onCancel: notifier.cancelDownload,
+            onTrigger: (GemmaModelInfo m) => notifier.triggerLocalDownload(m),
           ),
         ],
       ),
@@ -52,71 +56,124 @@ class LlmDownloadTile extends ConsumerWidget {
   }
 }
 
-// ─── State row ────────────────────────────────────────────────────────────────
-
 class _LlmStatusRow extends StatelessWidget {
   const _LlmStatusRow({
-    required this.state,
-    required this.onDownload,
+    required this.stateAsync,
+    required this.prefsAsync,
+    required this.readinessAsync,
     required this.onCancel,
     required this.onTrigger,
   });
 
-  final AiInferenceState state;
-  final Future<void> Function() onDownload;
+  final AsyncValue<AiInferenceState> stateAsync;
+  final AsyncValue<AppPreferences> prefsAsync;
+  final AsyncValue<LocalGemmaReadiness> readinessAsync;
   final void Function() onCancel;
   final void Function(GemmaModelInfo) onTrigger;
 
   @override
   Widget build(BuildContext context) {
-    return switch (state) {
-      AiReady(:final AiPreference mode, :final GemmaModelInfo activeModel) =>
-        _ReadyRow(
-          modelName: activeModel.name,
-          cloudMode: mode == AiPreference.cloud,
-        ),
-      AiLocalModelMissing(:final String? note) => _ActionRow(
-        badge: const _StatusBadge(label: 'Setup needed', ok: false),
-        primary: 'Download',
-        onPrimary: onDownload,
-        note: note,
-      ),
-      AiDownloading(
-        :final GemmaModelInfo model,
-        :final int progress,
-        :final String? statusMessage,
-      ) =>
-        _ProgressRow(
-          label: model.name,
-          progress: progress,
-          onCancel: onCancel,
-          statusMessage: statusMessage,
-        ),
-      AiInferenceError(:final String message) => _ErrRow(
-        message: _friendlyLlmModelError(message),
-      ),
-      _ => const _CheckingRow(),
+    if (stateAsync.hasError) {
+      return _ErrRow(
+        message: _friendlyLlmModelError(stateAsync.asError!.error.toString()),
+      );
+    }
+
+    final AiInferenceState? state = stateAsync.value;
+    if (state is AiDownloading) {
+      return _ProgressRow(
+        label: state.model.name,
+        progress: state.progress,
+        onCancel: onCancel,
+        statusMessage: state.statusMessage,
+      );
+    }
+    if (state is AiInferenceError) {
+      return _ErrRow(message: _friendlyLlmModelError(state.message));
+    }
+
+    if (prefsAsync.hasError) {
+      return _ErrRow(
+        message: _friendlyLlmModelError(prefsAsync.asError!.error.toString()),
+      );
+    }
+    if (readinessAsync.hasError) {
+      return _ErrRow(
+        message: _friendlyLlmModelError(readinessAsync.error.toString()),
+      );
+    }
+
+    final AppPreferences? prefs = prefsAsync.value;
+    final LocalGemmaReadiness? readiness = readinessAsync.value;
+    final GemmaModelInfo? activeModel = switch (state) {
+      AiReady(:final GemmaModelInfo activeModel) => activeModel,
+      AiLocalModelMissing(:final GemmaModelInfo model) => model,
+      _ => null,
     };
+
+    if (prefs == null || readiness == null || activeModel == null) {
+      return const _CheckingRow();
+    }
+
+    if (readiness.installed && readiness.usable) {
+      return _ReadyRow(
+        modelName: activeModel.name,
+        cloudMode: prefs.aiPreference == AiPreference.cloud,
+        note: prefs.aiPreference == AiPreference.cloud
+            ? 'Installed locally. Switch AI mode to Local when you want browser or on-device Gemma.'
+            : readiness.detail,
+      );
+    }
+
+    return _ActionRow(
+      badge: _StatusBadge(
+        label: readiness.installed ? 'Installed - not ready' : 'Not downloaded',
+        ok: readiness.installed ? null : false,
+      ),
+      primary: readiness.installed ? 'Reload' : 'Download',
+      onPrimary: () => onTrigger(activeModel),
+      note: readiness.detail,
+    );
   }
 }
 
 class _ReadyRow extends StatelessWidget {
-  const _ReadyRow({required this.modelName, required this.cloudMode});
+  const _ReadyRow({
+    required this.modelName,
+    required this.cloudMode,
+    this.note,
+  });
 
   final String modelName;
   final bool cloudMode;
+  final String? note;
 
   @override
   Widget build(BuildContext context) {
-    if (cloudMode) {
-      return const _ActionRow(
-        badge: _StatusBadge(label: 'Cloud active', ok: null),
-        note: 'Optional while Cloud is active.',
-      );
-    }
-    return _ActionRow(
-      badge: _StatusBadge(label: '$modelName ready', ok: true),
-      note: 'Ready for local Butty replies.',
+    return Column(
+      crossAxisAlignment: CrossAxisAlignment.start,
+      children: <Widget>[
+        Row(
+          children: <Widget>[
+            _StatusBadge(
+              label: cloudMode
+                  ? '$modelName installed - cloud selected'
+                  : '$modelName installed',
+              ok: true,
+            ),
+          ],
+        ),
+        if (note != null) ...<Widget>[
+          const SizedBox(height: 8),
+          Text(
+            note!,
+            style: TextStyle(
+              fontSize: 11,
+              color: Theme.of(context).colorScheme.onSurface.withAlpha(150),
+            ),
+          ),
+        ],
+      ],
     );
   }
 }
@@ -124,75 +181,43 @@ class _ReadyRow extends StatelessWidget {
 class _ActionRow extends StatelessWidget {
   const _ActionRow({
     required this.badge,
-    this.primary,
-    this.onPrimary,
+    required this.primary,
+    required this.onPrimary,
     this.note,
   });
 
   final Widget badge;
-  final String? primary;
-  final VoidCallback? onPrimary;
+  final String primary;
+  final VoidCallback onPrimary;
   final String? note;
 
   @override
   Widget build(BuildContext context) {
     final ColorScheme cs = Theme.of(context).colorScheme;
 
-    final Widget statusCopy = Column(
+    return Column(
       crossAxisAlignment: CrossAxisAlignment.start,
       children: <Widget>[
-        badge,
+        Row(
+          children: <Widget>[
+            badge,
+            const Spacer(),
+            ProfileManagementActionButton(
+              label: primary,
+              isPrimary: true,
+              onTap: onPrimary,
+            ),
+          ],
+        ),
         if (note != null) ...<Widget>[
-          const SizedBox(height: 6),
+          const SizedBox(height: 8),
           Text(
             note!,
-            style: TextStyle(
-              fontSize: 11,
-              height: 1.25,
-              color: cs.onSurface.withAlpha(150),
-            ),
+            style: TextStyle(fontSize: 11, color: cs.onSurface.withAlpha(150)),
           ),
         ],
       ],
     );
-    final Widget? action = primary != null && onPrimary != null
-        ? ProfileManagementActionButton(
-            label: primary!,
-            isPrimary: true,
-            onTap: onPrimary,
-          )
-        : null;
-
-    return LayoutBuilder(
-      builder: (BuildContext context, BoxConstraints constraints) {
-        if (constraints.maxWidth < 300) {
-          return Column(
-            crossAxisAlignment: CrossAxisAlignment.start,
-            children: <Widget>[
-              statusCopy,
-              if (action != null) ...<Widget>[
-                const SizedBox(height: 10),
-                Align(alignment: Alignment.centerLeft, child: action),
-              ],
-            ],
-          );
-        }
-
-        return Wrap(
-          alignment: WrapAlignment.spaceBetween,
-          crossAxisAlignment: WrapCrossAlignment.center,
-          spacing: 12,
-          runSpacing: 8,
-          children: <Widget>[
-            ConstrainedBox(
-              constraints: const BoxConstraints(minWidth: 180, maxWidth: 260),
-              child: statusCopy,
-            ),
-            ?action,
-          ],
-        );
-      },
-    );
   }
 }
 
@@ -216,20 +241,20 @@ class _ProgressRow extends StatelessWidget {
     return Column(
       crossAxisAlignment: CrossAxisAlignment.start,
       children: <Widget>[
-        Wrap(
-          alignment: WrapAlignment.spaceBetween,
-          crossAxisAlignment: WrapCrossAlignment.center,
-          spacing: 12,
-          runSpacing: 8,
+        Row(
+          mainAxisAlignment: MainAxisAlignment.spaceBetween,
           children: <Widget>[
-            ConstrainedBox(
-              constraints: const BoxConstraints(minWidth: 180, maxWidth: 260),
+            Text(
+              'Downloading $label… $progress%',
+              style: TextStyle(color: cs.primary, fontSize: 13),
+            ),
+            GestureDetector(
+              onTap: onCancel,
               child: Text(
-                'Downloading $label · $progress%',
-                style: TextStyle(color: cs.primary, fontSize: 13),
+                'Cancel',
+                style: TextStyle(color: cs.error, fontSize: 12),
               ),
             ),
-            ProfileManagementActionButton(label: 'Cancel', onTap: onCancel),
           ],
         ),
         if (statusMessage != null) ...<Widget>[
@@ -246,8 +271,6 @@ class _ProgressRow extends StatelessWidget {
   }
 }
 
-// ─── Shared small widgets ─────────────────────────────────────────────────────
-
 class _TileHeader extends StatelessWidget {
   const _TileHeader({
     required this.icon,
@@ -298,7 +321,6 @@ class _TileHeader extends StatelessWidget {
   }
 }
 
-/// `ok: true` → green installed, `ok: false` → red missing, `ok: null` → muted.
 class _StatusBadge extends StatelessWidget {
   const _StatusBadge({required this.label, required this.ok});
 
@@ -307,17 +329,16 @@ class _StatusBadge extends StatelessWidget {
 
   @override
   Widget build(BuildContext context) {
-    final ColorScheme cs = Theme.of(context).colorScheme;
     final Color bg = ok == true
-        ? cs.primaryContainer
+        ? Colors.green.shade800.withAlpha(40)
         : ok == false
-        ? cs.errorContainer
-        : cs.surfaceContainerHigh;
+        ? Colors.red.shade800.withAlpha(40)
+        : Theme.of(context).colorScheme.surfaceContainerHigh;
     final Color fg = ok == true
-        ? cs.onPrimaryContainer
+        ? Colors.green.shade300
         : ok == false
-        ? cs.onErrorContainer
-        : cs.onSurface.withAlpha(150);
+        ? Colors.red.shade300
+        : Theme.of(context).colorScheme.onSurface.withAlpha(150);
 
     return Container(
       padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 3),
@@ -325,12 +346,7 @@ class _StatusBadge extends StatelessWidget {
         color: bg,
         borderRadius: BorderRadius.circular(20),
       ),
-      child: Text(
-        label,
-        maxLines: 1,
-        overflow: TextOverflow.ellipsis,
-        style: TextStyle(fontSize: 11, color: fg),
-      ),
+      child: Text(label, style: TextStyle(fontSize: 11, color: fg)),
     );
   }
 }
@@ -341,7 +357,7 @@ class _CheckingRow extends StatelessWidget {
   @override
   Widget build(BuildContext context) {
     return Text(
-      'Checking status...',
+      'Checking…',
       style: TextStyle(
         fontSize: 13,
         color: Theme.of(context).colorScheme.onSurface.withAlpha(128),
@@ -357,14 +373,11 @@ class _ErrRow extends StatelessWidget {
 
   @override
   Widget build(BuildContext context) {
-    return Semantics(
-      label: 'Setup failed: $message',
-      child: Text(
-        message,
-        style: TextStyle(
-          fontSize: 12,
-          color: Theme.of(context).colorScheme.error,
-        ),
+    return Text(
+      'Error: $message',
+      style: TextStyle(
+        fontSize: 12,
+        color: Theme.of(context).colorScheme.error,
       ),
     );
   }
diff --git a/lib/features/translator/data/repositories/ai_inference_repository_impl.dart b/lib/features/translator/data/repositories/ai_inference_repository_impl.dart
index 94c7980..f04870f 100644
--- a/lib/features/translator/data/repositories/ai_inference_repository_impl.dart
+++ b/lib/features/translator/data/repositories/ai_inference_repository_impl.dart
@@ -29,7 +29,7 @@ class AiInferenceRepositoryImpl implements AiInferenceRepository {
   /// a stale snapshot.
   final AiPreference Function() preferenceResolver;
 
-  bool get _useCloud => kIsWeb || preferenceResolver() == AiPreference.cloud;
+  bool get _useCloud => preferenceResolver() == AiPreference.cloud;
 
   @override
   Future<Either<Failure, List<GemmaModelInfo>>> getAvailableModels() async {
@@ -47,9 +47,6 @@ class AiInferenceRepositoryImpl implements AiInferenceRepository {
   Future<Either<Failure, bool>> isLocalModelInstalled(
     GemmaModelInfo model,
   ) async {
-    if (kIsWeb) {
-      return right(false);
-    }
     try {
       final bool installed = await localDatasource.isInstalled(model);
       return right(installed);
@@ -63,13 +60,6 @@ class AiInferenceRepositoryImpl implements AiInferenceRepository {
     GemmaModelInfo model, {
     void Function(int progress)? onProgress,
   }) async {
-    if (kIsWeb) {
-      return left(
-        const Failure.unknown(
-          message: 'Local model download is unsupported on web.',
-        ),
-      );
-    }
     try {
       await localDatasource.download(model, onProgress: onProgress);
       return right(unit);
@@ -80,9 +70,7 @@ class AiInferenceRepositoryImpl implements AiInferenceRepository {
 
   @override
   void cancelDownload() {
-    if (!kIsWeb) {
-      localDatasource.cancelDownload();
-    }
+    localDatasource.cancelDownload();
   }
 
   @override
@@ -150,7 +138,7 @@ class AiInferenceRepositoryImpl implements AiInferenceRepository {
     String mimeType = 'image/png',
     String? prompt,
   }) {
-    if (_useCloud) {
+    if (kIsWeb || _useCloud) {
       return cloudDatasource.analyzeImage(
         imageBytes,
         mimeType: mimeType,

From 0b4254a22c922c5427e4a99b68e3ca265dd2f40b Mon Sep 17 00:00:00 2001
From: JamTheDev <2004jamvillarosa@gmail.com>
Date: Mon, 11 May 2026 14:11:24 +0800
Subject: [PATCH 3/5] test: add web gemma browser preflight

---
 .../web_gemma_model_preflight.dart            | 25 ++++++++
 .../web_gemma_model_preflight_stub.dart       | 14 +++++
 .../web_gemma_model_preflight_web.dart        | 59 +++++++++++++++++++
 ...eb_gemma_model_preflight_browser_test.dart | 45 ++++++++++++++
 4 files changed, 143 insertions(+)
 create mode 100644 lib/features/translator/data/datasources/web_gemma_model_preflight.dart
 create mode 100644 lib/features/translator/data/datasources/web_gemma_model_preflight_stub.dart
 create mode 100644 lib/features/translator/data/datasources/web_gemma_model_preflight_web.dart
 create mode 100644 test/features/translator/data/datasources/web_gemma_model_preflight_browser_test.dart

diff --git a/lib/features/translator/data/datasources/web_gemma_model_preflight.dart b/lib/features/translator/data/datasources/web_gemma_model_preflight.dart
new file mode 100644
index 0000000..cf5d64a
--- /dev/null
+++ b/lib/features/translator/data/datasources/web_gemma_model_preflight.dart
@@ -0,0 +1,25 @@
+import 'package:meta/meta.dart';
+
+import 'package:kudlit_ph/features/translator/data/datasources/web_gemma_model_preflight_stub.dart'
+    if (dart.library.js_interop) 'package:kudlit_ph/features/translator/data/datasources/web_gemma_model_preflight_web.dart';
+
+abstract interface class WebGemmaModelPreflight {
+  Future<WebGemmaModelPreflightResult> run(String modelUrl);
+}
+
+@immutable
+class WebGemmaModelPreflightResult {
+  const WebGemmaModelPreflightResult({
+    required this.modelUrl,
+    required this.installed,
+    required this.responsePreview,
+  });
+
+  final String modelUrl;
+  final bool installed;
+  final String responsePreview;
+}
+
+WebGemmaModelPreflight createWebGemmaModelPreflight() {
+  return createPlatformWebGemmaModelPreflight();
+}
diff --git a/lib/features/translator/data/datasources/web_gemma_model_preflight_stub.dart b/lib/features/translator/data/datasources/web_gemma_model_preflight_stub.dart
new file mode 100644
index 0000000..c7095c3
--- /dev/null
+++ b/lib/features/translator/data/datasources/web_gemma_model_preflight_stub.dart
@@ -0,0 +1,14 @@
+import 'package:kudlit_ph/features/translator/data/datasources/web_gemma_model_preflight.dart';
+
+WebGemmaModelPreflight createPlatformWebGemmaModelPreflight() {
+  return const _WebGemmaModelPreflightStub();
+}
+
+class _WebGemmaModelPreflightStub implements WebGemmaModelPreflight {
+  const _WebGemmaModelPreflightStub();
+
+  @override
+  Future<WebGemmaModelPreflightResult> run(String modelUrl) async {
+    throw UnsupportedError('Web Gemma preflight is only available on web.');
+  }
+}
diff --git a/lib/features/translator/data/datasources/web_gemma_model_preflight_web.dart b/lib/features/translator/data/datasources/web_gemma_model_preflight_web.dart
new file mode 100644
index 0000000..4370bc2
--- /dev/null
+++ b/lib/features/translator/data/datasources/web_gemma_model_preflight_web.dart
@@ -0,0 +1,59 @@
+import 'package:flutter_gemma/flutter_gemma.dart';
+
+import 'package:kudlit_ph/features/translator/data/datasources/flutter_gemma_bootstrap.dart';
+import 'package:kudlit_ph/features/translator/data/datasources/gemma_model_file_type.dart';
+import 'package:kudlit_ph/features/translator/data/datasources/web_gemma_model_preflight.dart';
+
+WebGemmaModelPreflight createPlatformWebGemmaModelPreflight() {
+  return const _WebGemmaModelPreflightWeb();
+}
+
+class _WebGemmaModelPreflightWeb implements WebGemmaModelPreflight {
+  const _WebGemmaModelPreflightWeb();
+
+  @override
+  Future<WebGemmaModelPreflightResult> run(String modelUrl) async {
+    await initializeFlutterGemma();
+
+    final Uri uri = Uri.parse(modelUrl);
+    final String fileName = uri.pathSegments.isEmpty
+        ? modelUrl
+        : uri.pathSegments.last;
+
+    await FlutterGemma.installModel(
+      modelType: ModelType.gemma4,
+      fileType: resolveGemmaModelFileType(modelUrl),
+    ).fromNetwork(modelUrl).install();
+
+    final bool installed = await FlutterGemma.isModelInstalled(fileName);
+    final InferenceModel model = await FlutterGemma.getActiveModel(
+      maxTokens: 128,
+    );
+    final InferenceChat chat = await model.createChat(
+      systemInstruction: 'Reply in plain text with exactly one word.',
+    );
+
+    final StringBuffer buffer = StringBuffer();
+    try {
+      await chat.addQueryChunk(Message.text(text: 'ready', isUser: true));
+      await for (final ModelResponse response
+          in chat.generateChatResponseAsync()) {
+        if (response is TextResponse) {
+          buffer.write(response.token);
+          if (buffer.toString().trim().isNotEmpty) {
+            break;
+          }
+        }
+      }
+
+      return WebGemmaModelPreflightResult(
+        modelUrl: modelUrl,
+        installed: installed,
+        responsePreview: buffer.toString().trim(),
+      );
+    } finally {
+      await chat.close();
+      await model.close();
+    }
+  }
+}
diff --git a/test/features/translator/data/datasources/web_gemma_model_preflight_browser_test.dart b/test/features/translator/data/datasources/web_gemma_model_preflight_browser_test.dart
new file mode 100644
index 0000000..a0ab703
--- /dev/null
+++ b/test/features/translator/data/datasources/web_gemma_model_preflight_browser_test.dart
@@ -0,0 +1,45 @@
+import 'package:flutter/foundation.dart';
+import 'package:flutter_test/flutter_test.dart';
+
+import 'package:kudlit_ph/features/translator/data/datasources/web_gemma_model_preflight.dart';
+
+const String _kGemmaWebModelUrl = String.fromEnvironment(
+  'TEST_WEB_GEMMA_MODEL_URL',
+  defaultValue:
+      'https://huggingface.co/litert-community/gemma-4-E2B-it-litert-lm/resolve/main/gemma-4-E2B-it.litertlm',
+);
+
+void main() {
+  TestWidgetsFlutterBinding.ensureInitialized();
+
+  testWidgets(
+    'loads the real Gemma web model in a browser session',
+    (WidgetTester tester) async {
+      if (!kIsWeb) {
+        return;
+      }
+
+      final WebGemmaModelPreflightResult result =
+          await createWebGemmaModelPreflight().run(_kGemmaWebModelUrl);
+
+      expect(result.modelUrl, _kGemmaWebModelUrl);
+      expect(result.installed, isTrue);
+    },
+    timeout: const Timeout(Duration(minutes: 20)),
+  );
+
+  testWidgets(
+    'generates real browser output from the Gemma web model',
+    (WidgetTester tester) async {
+      if (!kIsWeb) {
+        return;
+      }
+
+      final WebGemmaModelPreflightResult result =
+          await createWebGemmaModelPreflight().run(_kGemmaWebModelUrl);
+
+      expect(result.responsePreview.trim(), isNotEmpty);
+    },
+    timeout: const Timeout(Duration(minutes: 20)),
+  );
+}

From aff39d3bff5c3d83526fdc6298026fc95cff1a79 Mon Sep 17 00:00:00 2001
From: JamTheDev <2004jamvillarosa@gmail.com>
Date: Mon, 11 May 2026 14:31:33 +0800
Subject: [PATCH 4/5] fix: simplify offline download copy

---
 .../providers/model_setup_controller.dart     |  3 +-
 .../screens/model_setup_screen.dart           | 27 +++----
 .../butty_chat/butty_model_mode_selector.dart |  5 +-
 .../widgets/settings/ai_models_section.dart   | 12 +--
 .../widgets/settings/llm_download_tile.dart   | 41 ++++------
 .../settings/local_model_status_row.dart      | 77 +++++++++----------
 .../settings/vision_download_tile.dart        | 34 +++-----
 .../yolo_model_selection_provider.dart        | 37 ++++-----
 .../widgets/model_not_ready_screen.dart       |  4 +-
 .../presentation/widgets/scanner_camera.dart  |  9 +--
 .../screens/model_setup_screen_test.dart      | 16 ++--
 .../widgets/ai_models_section_test.dart       | 38 +++++----
 .../web_yolo_output_parser_test.dart          |  2 +-
 .../widgets/scanner_camera_status_test.dart   |  8 +-
 14 files changed, 141 insertions(+), 172 deletions(-)

diff --git a/lib/features/home/presentation/providers/model_setup_controller.dart b/lib/features/home/presentation/providers/model_setup_controller.dart
index 25cea22..c60ccea 100644
--- a/lib/features/home/presentation/providers/model_setup_controller.dart
+++ b/lib/features/home/presentation/providers/model_setup_controller.dart
@@ -65,8 +65,7 @@ class ModelSetupController extends Notifier<ModelSetupState> {
       if (!gemmaReadiness.installed || !gemmaReadiness.usable) {
         state = state.copyWith(
           busy: false,
-          errorMessage:
-              'Download the Gemma model before continuing with offline AI.',
+          errorMessage: 'Finish the offline downloads before continuing.',
         );
         return;
       }
diff --git a/lib/features/home/presentation/screens/model_setup_screen.dart b/lib/features/home/presentation/screens/model_setup_screen.dart
index a93d37c..aa70588 100644
--- a/lib/features/home/presentation/screens/model_setup_screen.dart
+++ b/lib/features/home/presentation/screens/model_setup_screen.dart
@@ -52,7 +52,7 @@ class _ModelSetupScreenState extends ConsumerState<ModelSetupScreen> {
   String _friendlyModelSetupError(String rawMessage) {
     final String message = rawMessage.trim();
     if (message.isEmpty) {
-      return 'Local AI setup is paused. You can use cloud AI and retry later.';
+      return 'Offline setup is paused. You can keep using online help and try again later.';
     }
 
     final String lower = message.toLowerCase();
@@ -73,7 +73,7 @@ class _ModelSetupScreenState extends ConsumerState<ModelSetupScreen> {
     }
 
     if (lower.contains('no ai models configured')) {
-      return 'The local model list is not available yet. You can use cloud AI for now.';
+      return 'Offline downloads are not available right now. You can keep using online help for now.';
     }
 
     final bool looksTechnical =
@@ -84,7 +84,7 @@ class _ModelSetupScreenState extends ConsumerState<ModelSetupScreen> {
         lower.contains('uri=') ||
         lower.contains('https://');
     if (looksTechnical) {
-      return 'Local AI setup is paused. You can use cloud AI and retry later.';
+      return 'Offline setup is paused. You can keep using online help and try again later.';
     }
 
     return message;
@@ -368,7 +368,7 @@ class _SetupHeadline extends StatelessWidget {
       crossAxisAlignment: CrossAxisAlignment.start,
       children: <Widget>[
         Text(
-          'Power up Kudlit',
+          'Get ready to use Kudlit',
           style: TextStyle(
             color: KudlitColors.blue900,
             fontSize: compact ? 24 : 28,
@@ -378,10 +378,8 @@ class _SetupHeadline extends StatelessWidget {
         SizedBox(height: compact ? 8 : 10),
         Text(
           kIsWeb
-              ? 'Kudlit prepares both the browser scanner model and the '
-                    'browser Gemma model here before you start.'
-              : 'Kudlit uses on-device AI models for Baybayin recognition '
-                    'and translation — no internet needed once downloaded.',
+              ? 'Set up the downloads Kudlit needs before you start.'
+              : 'Download these once so key features can keep working even without internet.',
           style: TextStyle(
             color: KudlitColors.grey300,
             fontSize: compact ? 13 : 15,
@@ -422,11 +420,8 @@ class _DownloadNotice extends StatelessWidget {
           Expanded(
             child: Text(
               kIsWeb
-                  ? 'On web, both the scanner model and Gemma are loaded and '
-                        'stored by the browser. The first setup can take a '
-                        'while for large Gemma files.'
-                  : 'AI model files are typically 1–5 GB. '
-                        'Wi-Fi recommended. Download continues in the background.',
+                  ? 'The first setup happens in this browser and may take a while.'
+                  : 'These downloads can be large. Wi-Fi is recommended.',
               style: TextStyle(
                 color: KudlitColors.blue800,
                 fontSize: compact ? 10 : 11,
@@ -455,7 +450,7 @@ class _SetupActions extends StatelessWidget {
 
   @override
   Widget build(BuildContext context) {
-    final String label = busy ? 'Checking models' : 'Continue';
+    final String label = busy ? 'Checking setup' : 'Continue';
 
     return Column(
       crossAxisAlignment: CrossAxisAlignment.stretch,
@@ -464,7 +459,7 @@ class _SetupActions extends StatelessWidget {
           button: true,
           enabled: !busy,
           label: label,
-          hint: 'Checks whether the required models are ready, then continues.',
+          hint: 'Checks whether everything is ready, then continues.',
           child: FilledButton.icon(
             onPressed: busy ? null : onContinue,
             icon: busy
@@ -499,7 +494,7 @@ class _SetupActions extends StatelessWidget {
             disabledForegroundColor: KudlitColors.grey500,
           ),
           child: const Text(
-            'Not now - use cloud AI',
+            'Not now - use online help',
             style: TextStyle(fontSize: 14, fontWeight: FontWeight.w600),
           ),
         ),
diff --git a/lib/features/home/presentation/widgets/butty_chat/butty_model_mode_selector.dart b/lib/features/home/presentation/widgets/butty_chat/butty_model_mode_selector.dart
index 53d59dd..7dde0c8 100644
--- a/lib/features/home/presentation/widgets/butty_chat/butty_model_mode_selector.dart
+++ b/lib/features/home/presentation/widgets/butty_chat/butty_model_mode_selector.dart
@@ -55,8 +55,9 @@ class ButtyModelModeSelector extends ConsumerWidget {
     final String helperText = switch (offlineStatusAsync) {
       AsyncData(:final ButtyOfflineStatus value) =>
         value.detail ?? 'Offline status unknown.',
-      AsyncError() => 'Offline check failed. Use cloud or retry later.',
-      _ => 'Checking whether the offline Gemma model is installed…',
+      AsyncError() =>
+        'Offline check failed. Use online help or try again later.',
+      _ => 'Checking whether offline help is ready…',
     };
 
     final Widget pills = Container(
diff --git a/lib/features/home/presentation/widgets/settings/ai_models_section.dart b/lib/features/home/presentation/widgets/settings/ai_models_section.dart
index 06cd39c..e0d38b4 100644
--- a/lib/features/home/presentation/widgets/settings/ai_models_section.dart
+++ b/lib/features/home/presentation/widgets/settings/ai_models_section.dart
@@ -6,12 +6,6 @@ import 'settings_divider.dart';
 import 'settings_section_label.dart';
 import 'vision_download_tile.dart';
 
-/// Settings section that shows download status and controls for both
-/// on-device AI models:
-///
-/// - **Gemma 4 E2B** — LLM used by Butty (offline chat / feedback).
-/// - **KudVis-1-Turbo** — YOLO TFLite used by the OCR / camera scanner.
-///
 class AiModelsSection extends StatelessWidget {
   const AiModelsSection({super.key});
 
@@ -20,7 +14,7 @@ class AiModelsSection extends StatelessWidget {
     return Column(
       crossAxisAlignment: CrossAxisAlignment.start,
       children: <Widget>[
-        const SettingsSectionLabel(text: 'AI models'),
+        const SettingsSectionLabel(text: 'Offline downloads'),
         SettingsCard(
           children: <Widget>[
             const _AiModelsIntro(),
@@ -65,7 +59,7 @@ class _AiModelsIntro extends StatelessWidget {
               crossAxisAlignment: CrossAxisAlignment.start,
               children: <Widget>[
                 Text(
-                  'Local AI setup',
+                  'Use Kudlit offline',
                   style: TextStyle(
                     fontSize: 14,
                     fontWeight: FontWeight.w800,
@@ -74,7 +68,7 @@ class _AiModelsIntro extends StatelessWidget {
                 ),
                 const SizedBox(height: 3),
                 Text(
-                  'Install once for offline Butty and scanner setup.',
+                  'Set these up once to keep replies and camera reading available without internet.',
                   style: TextStyle(
                     fontSize: 12,
                     height: 1.3,
diff --git a/lib/features/home/presentation/widgets/settings/llm_download_tile.dart b/lib/features/home/presentation/widgets/settings/llm_download_tile.dart
index 43a6eb9..1895c37 100644
--- a/lib/features/home/presentation/widgets/settings/llm_download_tile.dart
+++ b/lib/features/home/presentation/widgets/settings/llm_download_tile.dart
@@ -10,10 +10,6 @@ import 'package:kudlit_ph/features/translator/presentation/providers/translator_
 
 import 'profile_management_action_button.dart';
 
-/// Settings tile for the Gemma 4 LLM model (Butty offline AI).
-///
-/// Shows install status and a download/cancel button driven by
-/// [AiInferenceNotifier] so it stays in sync with the chat screen.
 class LlmDownloadTile extends ConsumerWidget {
   const LlmDownloadTile({super.key});
 
@@ -39,8 +35,8 @@ class LlmDownloadTile extends ConsumerWidget {
         children: <Widget>[
           const _TileHeader(
             icon: Icons.psychology_rounded,
-            label: 'Gemma 4 E2B',
-            sublabel: 'Butty offline AI  ·  ~2.4 GB',
+            label: 'Butty replies',
+            sublabel: 'Offline help  ·  large download',
           ),
           const SizedBox(height: 10),
           _LlmStatusRow(
@@ -82,7 +78,6 @@ class _LlmStatusRow extends StatelessWidget {
     final AiInferenceState? state = stateAsync.value;
     if (state is AiDownloading) {
       return _ProgressRow(
-        label: state.model.name,
         progress: state.progress,
         onCancel: onCancel,
         statusMessage: state.statusMessage,
@@ -117,34 +112,30 @@ class _LlmStatusRow extends StatelessWidget {
 
     if (readiness.installed && readiness.usable) {
       return _ReadyRow(
-        modelName: activeModel.name,
         cloudMode: prefs.aiPreference == AiPreference.cloud,
         note: prefs.aiPreference == AiPreference.cloud
-            ? 'Installed locally. Switch AI mode to Local when you want browser or on-device Gemma.'
-            : readiness.detail,
+            ? 'Downloaded and ready whenever you switch to Offline mode.'
+            : 'Downloaded and ready to use without internet.',
       );
     }
 
     return _ActionRow(
       badge: _StatusBadge(
-        label: readiness.installed ? 'Installed - not ready' : 'Not downloaded',
+        label: readiness.installed ? 'Almost ready' : 'Needs download',
         ok: readiness.installed ? null : false,
       ),
       primary: readiness.installed ? 'Reload' : 'Download',
       onPrimary: () => onTrigger(activeModel),
-      note: readiness.detail,
+      note: readiness.installed
+          ? 'We are still getting this ready.'
+          : 'Download once to use Butty without internet.',
     );
   }
 }
 
 class _ReadyRow extends StatelessWidget {
-  const _ReadyRow({
-    required this.modelName,
-    required this.cloudMode,
-    this.note,
-  });
+  const _ReadyRow({required this.cloudMode, this.note});
 
-  final String modelName;
   final bool cloudMode;
   final String? note;
 
@@ -156,9 +147,7 @@ class _ReadyRow extends StatelessWidget {
         Row(
           children: <Widget>[
             _StatusBadge(
-              label: cloudMode
-                  ? '$modelName installed - cloud selected'
-                  : '$modelName installed',
+              label: cloudMode ? 'Downloaded' : 'Ready offline',
               ok: true,
             ),
           ],
@@ -223,13 +212,11 @@ class _ActionRow extends StatelessWidget {
 
 class _ProgressRow extends StatelessWidget {
   const _ProgressRow({
-    required this.label,
     required this.progress,
     required this.onCancel,
     this.statusMessage,
   });
 
-  final String label;
   final int progress;
   final VoidCallback onCancel;
   final String? statusMessage;
@@ -245,7 +232,7 @@ class _ProgressRow extends StatelessWidget {
           mainAxisAlignment: MainAxisAlignment.spaceBetween,
           children: <Widget>[
             Text(
-              'Downloading $label… $progress%',
+              'Downloading… $progress%',
               style: TextStyle(color: cs.primary, fontSize: 13),
             ),
             GestureDetector(
@@ -386,7 +373,7 @@ class _ErrRow extends StatelessWidget {
 String _friendlyLlmModelError(String rawMessage) {
   final String message = rawMessage.trim();
   if (message.isEmpty) {
-    return 'Local AI setup is paused. You can use cloud AI and retry later.';
+    return 'Offline setup is paused. You can keep using online help and try again later.';
   }
 
   final String lower = message.toLowerCase();
@@ -407,7 +394,7 @@ String _friendlyLlmModelError(String rawMessage) {
   }
 
   if (lower.contains('no ai models configured')) {
-    return 'The local model list is not available yet. You can use cloud AI for now.';
+    return 'Offline downloads are not available right now. You can keep using online help for now.';
   }
 
   final bool looksTechnical =
@@ -418,7 +405,7 @@ String _friendlyLlmModelError(String rawMessage) {
       lower.contains('uri=') ||
       lower.contains('https://');
   if (looksTechnical) {
-    return 'Local AI setup is paused. You can use cloud AI and retry later.';
+    return 'Offline setup is paused. You can keep using online help and try again later.';
   }
 
   return message;
diff --git a/lib/features/home/presentation/widgets/settings/local_model_status_row.dart b/lib/features/home/presentation/widgets/settings/local_model_status_row.dart
index 7920962..87a30e9 100644
--- a/lib/features/home/presentation/widgets/settings/local_model_status_row.dart
+++ b/lib/features/home/presentation/widgets/settings/local_model_status_row.dart
@@ -23,7 +23,7 @@ class LocalModelStatusRow extends ConsumerWidget {
           Expanded(
             child: stateAsync.when(
               loading: () => Text(
-                'Checking Gemma model status...',
+                'Checking offline download status...',
                 style: TextStyle(
                   color: cs.onSurface.withAlpha(150),
                   fontSize: 13,
@@ -52,24 +52,24 @@ class _StatusContent extends ConsumerWidget {
     final ColorScheme cs = Theme.of(context).colorScheme;
 
     return switch (state) {
-      AiReady(:final AiPreference mode, :final activeModel) =>
+      AiReady(:final AiPreference mode) =>
         mode == AiPreference.cloud
             ? Text(
-                'Cloud AI active — Gemma model not needed.',
+                'Online help is active. Offline download is optional.',
                 style: TextStyle(
                   color: cs.onSurface.withAlpha(150),
                   fontSize: 13,
                 ),
               )
             : Text(
-                '${activeModel.name} installed and ready.',
+                'Offline download is ready.',
                 style: TextStyle(
                   color: Colors.green.shade600,
                   fontSize: 13,
                   fontWeight: FontWeight.w600,
                 ),
               ),
-      AiLocalModelMissing(:final model, :final String? note) => Column(
+      AiLocalModelMissing(:final String? note) => Column(
         crossAxisAlignment: CrossAxisAlignment.start,
         children: <Widget>[
           Row(
@@ -78,7 +78,7 @@ class _StatusContent extends ConsumerWidget {
               const SizedBox(width: 6),
               Expanded(
                 child: Text(
-                  '${model.name} not installed. Requires ~1.5 GB.',
+                  'Offline help is not downloaded yet.',
                   style: TextStyle(color: cs.error, fontSize: 13),
                 ),
               ),
@@ -102,49 +102,44 @@ class _StatusContent extends ConsumerWidget {
           ],
         ],
       ),
-      AiDownloading(
-        :final model,
-        :final progress,
-        :final String? statusMessage,
-      ) =>
-        Column(
-          crossAxisAlignment: CrossAxisAlignment.start,
-          children: <Widget>[
-            Row(
-              mainAxisAlignment: MainAxisAlignment.spaceBetween,
-              children: <Widget>[
-                Text(
-                  'Downloading ${model.name}… $progress%',
-                  style: TextStyle(color: cs.primary, fontSize: 13),
-                ),
-                InkWell(
-                  onTap: () => ref
-                      .read(aiInferenceNotifierProvider.notifier)
-                      .cancelDownload(),
-                  child: Icon(Icons.cancel_rounded, size: 16, color: cs.error),
-                ),
-              ],
-            ),
-            if (statusMessage != null) ...<Widget>[
-              const SizedBox(height: 4),
+      AiDownloading(:final progress, :final String? statusMessage) => Column(
+        crossAxisAlignment: CrossAxisAlignment.start,
+        children: <Widget>[
+          Row(
+            mainAxisAlignment: MainAxisAlignment.spaceBetween,
+            children: <Widget>[
               Text(
-                statusMessage,
-                style: TextStyle(
-                  color: cs.onSurface.withAlpha(150),
-                  fontSize: 11,
-                ),
+                'Downloading… $progress%',
+                style: TextStyle(color: cs.primary, fontSize: 13),
+              ),
+              InkWell(
+                onTap: () => ref
+                    .read(aiInferenceNotifierProvider.notifier)
+                    .cancelDownload(),
+                child: Icon(Icons.cancel_rounded, size: 16, color: cs.error),
               ),
             ],
-            const SizedBox(height: 6),
-            LinearProgressIndicator(value: progress / 100),
+          ),
+          if (statusMessage != null) ...<Widget>[
+            const SizedBox(height: 4),
+            Text(
+              statusMessage,
+              style: TextStyle(
+                color: cs.onSurface.withAlpha(150),
+                fontSize: 11,
+              ),
+            ),
           ],
-        ),
+          const SizedBox(height: 6),
+          LinearProgressIndicator(value: progress / 100),
+        ],
+      ),
       AiInferenceError(:final message) => Text(
-        'Gemma error: $message',
+        'Offline download error: $message',
         style: TextStyle(color: cs.error, fontSize: 13),
       ),
       _ => Text(
-        'Initializing Gemma…',
+        'Getting offline help ready…',
         style: TextStyle(color: cs.onSurface.withAlpha(150), fontSize: 13),
       ),
     };
diff --git a/lib/features/home/presentation/widgets/settings/vision_download_tile.dart b/lib/features/home/presentation/widgets/settings/vision_download_tile.dart
index 495d7cc..f5913f0 100644
--- a/lib/features/home/presentation/widgets/settings/vision_download_tile.dart
+++ b/lib/features/home/presentation/widgets/settings/vision_download_tile.dart
@@ -10,10 +10,6 @@ import 'package:kudlit_ph/features/translator/domain/entities/ai_model_info.dart
 
 import 'profile_management_action_button.dart';
 
-/// Settings tile for the KudVis vision model (YOLO OCR / camera scanner).
-///
-/// Manages its own download/probe progress locally and invalidates the shared
-/// setup-status providers after a successful prepare action.
 class VisionDownloadTile extends ConsumerStatefulWidget {
   const VisionDownloadTile({super.key});
 
@@ -148,29 +144,23 @@ class _VisionStatusRow extends ConsumerWidget {
       error: (Object e, _) => _ErrRow(message: e.toString()),
       data: (VisionModelSetupStatus status) {
         if (status.ready) {
-          final String label = kIsWeb
-              ? '${model.name} ready in browser'
-              : '${model.name} ready';
-          final String supportingText = kIsWeb
-              ? 'Ready for browser scanner startup.'
-              : 'Ready for local scanner startup.';
           return _VisionActionRow(
-            badge: _StatusBadge(label: label, ok: true),
-            supportingText: supportingText,
+            badge: const _StatusBadge(label: 'Ready to scan', ok: true),
+            supportingText: 'Downloaded and ready when you open the scanner.',
             action: ProfileManagementActionButton(
-              label: kIsWeb ? 'Reload' : 'Re-download',
+              label: 'Set up again',
               onTap: onPrepare,
             ),
           );
         }
 
         return _VisionActionRow(
-          badge: const _StatusBadge(label: 'Setup needed', ok: false),
+          badge: const _StatusBadge(label: 'Needs download', ok: false),
           supportingText: kIsWeb
-              ? status.message
-              : 'Download once before live recognition.',
+              ? 'Set this up once to use camera reading in this browser.'
+              : 'Download once before using camera reading.',
           action: ProfileManagementActionButton(
-            label: kIsWeb ? 'Load in browser' : 'Download',
+            label: 'Set up',
             isPrimary: true,
             onTap: onPrepare,
           ),
@@ -261,7 +251,7 @@ class _DownloadProgressRow extends StatelessWidget {
         children: <Widget>[
           Flexible(
             child: Text(
-              'Loading $label in the browser...',
+              'Getting camera reading ready...',
               maxLines: 2,
               overflow: TextOverflow.ellipsis,
               style: TextStyle(color: cs.primary, fontSize: 13),
@@ -281,7 +271,7 @@ class _DownloadProgressRow extends StatelessWidget {
       crossAxisAlignment: CrossAxisAlignment.start,
       children: <Widget>[
         Text(
-          'Downloading $label - $progress%',
+          'Downloading… $progress%',
           style: TextStyle(color: cs.primary, fontSize: 13),
         ),
         const SizedBox(height: 6),
@@ -307,7 +297,7 @@ class _VisionTileHeader extends StatelessWidget {
             crossAxisAlignment: CrossAxisAlignment.start,
             children: <Widget>[
               Text(
-                'KudVis-1-Turbo',
+                'Camera reading',
                 maxLines: 1,
                 overflow: TextOverflow.ellipsis,
                 style: TextStyle(
@@ -318,8 +308,8 @@ class _VisionTileHeader extends StatelessWidget {
               ),
               Text(
                 kIsWeb
-                    ? 'Baybayin OCR scanner - YOLOv12 via tflite_web'
-                    : 'Local scanner recognition',
+                    ? 'Reads Baybayin in this browser'
+                    : 'Reads Baybayin with your camera',
                 maxLines: 2,
                 overflow: TextOverflow.ellipsis,
                 style: TextStyle(
diff --git a/lib/features/scanner/presentation/providers/yolo_model_selection_provider.dart b/lib/features/scanner/presentation/providers/yolo_model_selection_provider.dart
index bfd4904..76eadff 100644
--- a/lib/features/scanner/presentation/providers/yolo_model_selection_provider.dart
+++ b/lib/features/scanner/presentation/providers/yolo_model_selection_provider.dart
@@ -299,8 +299,8 @@ final FutureProvider<VisionModelSetupStatus> visionModelSetupStatusProvider =
       if (models.isEmpty) {
         return const VisionModelSetupStatus(
           ready: false,
-          title: 'No scanner model configured',
-          message: 'Add an enabled vision model in Supabase to use scanning.',
+          title: 'Scanner setup unavailable',
+          message: 'Scanning is not ready yet.',
         );
       }
 
@@ -323,16 +323,14 @@ final FutureProvider<VisionModelSetupStatus> visionModelSetupStatusProvider =
           await createWebVisionModelPreflight().run(active.modelLink);
           return VisionModelSetupStatus(
             ready: true,
-            title: 'Browser scanner ready',
-            message:
-                '${active.name} loaded successfully and passed a browser '
-                'inference warm-up.',
+            title: 'Scanner ready',
+            message: 'Camera reading is ready to use.',
             model: active,
           );
         } catch (e) {
           return VisionModelSetupStatus(
             ready: false,
-            title: 'Browser scanner needs attention',
+            title: 'Scanner needs attention',
             message: friendlyVisionModelError(e.toString()),
             model: active,
           );
@@ -345,16 +343,16 @@ final FutureProvider<VisionModelSetupStatus> visionModelSetupStatusProvider =
       if (upToDate) {
         return VisionModelSetupStatus(
           ready: true,
-          title: 'Scanner model downloaded',
-          message: '${active.name} is ready for on-device scanning.',
+          title: 'Scanner ready',
+          message: 'Camera reading is ready to use.',
           model: active,
         );
       }
 
       return VisionModelSetupStatus(
         ready: false,
-        title: 'Scanner model not downloaded',
-        message: 'Download ${active.name} to enable the camera scanner.',
+        title: 'Scanner needs download',
+        message: 'Download this to use camera reading.',
         model: active,
       );
     });
@@ -365,24 +363,23 @@ String friendlyVisionModelError(String rawMessage) {
   if (lower.contains('404') ||
       lower.contains('not found') ||
       lower.contains('object not found')) {
-    return 'The scanner model file is missing from Supabase Storage.';
+    return 'This download is unavailable right now. Please try again later.';
   }
   if (lower.contains('cors') || lower.contains('failed to fetch')) {
-    return 'The browser could not load the scanner model. Check CORS and the '
-        'public model URL.';
+    return 'This download could not be prepared right now. Please try again.';
   }
   if (lower.contains('input type')) {
-    return 'The web scanner model uses an unsupported input type for browser '
-        'inference.';
+    return 'This download is not ready for this device yet.';
   }
   if (lower.contains('shape') || lower.contains('tensor')) {
-    return 'The scanner model loaded, but its tensor format is not compatible '
-        'with the current web parser.';
+    return 'This download is not ready for this device yet.';
   }
   if (lower.contains('model') || lower.contains('tflite')) {
-    return 'The browser could not prepare the scanner model.';
+    return 'This download could not be prepared right now.';
   }
-  return raw.isEmpty ? 'The browser could not prepare the scanner model.' : raw;
+  return raw.isEmpty
+      ? 'This download could not be prepared right now.'
+      : 'Something went wrong while getting this ready. Please try again.';
 }
 
 /// Sentinel thrown while the model catalog is still loading. Callers
diff --git a/lib/features/scanner/presentation/widgets/model_not_ready_screen.dart b/lib/features/scanner/presentation/widgets/model_not_ready_screen.dart
index 84afb87..59b6eb3 100644
--- a/lib/features/scanner/presentation/widgets/model_not_ready_screen.dart
+++ b/lib/features/scanner/presentation/widgets/model_not_ready_screen.dart
@@ -156,7 +156,7 @@ class _ErrorContent extends StatelessWidget {
         if (needsSetup) ...<Widget>[
           const SizedBox(height: 8),
           Text(
-            'Open Settings > AI models to install or update scanner models.',
+            'Open Settings > Offline downloads to get camera reading ready.',
             textAlign: TextAlign.center,
             style: TextStyle(
               fontSize: 13,
@@ -176,7 +176,7 @@ class _ErrorContent extends StatelessWidget {
                 onPressed: onSetup,
                 style: FilledButton.styleFrom(minimumSize: const Size(0, 44)),
                 icon: const Icon(Icons.tune_rounded, size: 18),
-                label: const Text('Open AI models'),
+                label: const Text('Open downloads'),
               ),
             FilledButton.tonal(
               onPressed: onRetry,
diff --git a/lib/features/scanner/presentation/widgets/scanner_camera.dart b/lib/features/scanner/presentation/widgets/scanner_camera.dart
index a2b71fc..74e452a 100644
--- a/lib/features/scanner/presentation/widgets/scanner_camera.dart
+++ b/lib/features/scanner/presentation/widgets/scanner_camera.dart
@@ -513,7 +513,7 @@ class _WebCameraPreviewState extends ConsumerState<_WebCameraPreview> {
       return const ScanNotice(
         title: 'Web model unavailable',
         message:
-            'The active scanner model file is missing from storage. Use Gallery for now or update the model URL.',
+            'Camera reading is not ready right now. Use Gallery for now and try again later.',
         kind: ScanNoticeKind.error,
       );
     }
@@ -521,15 +521,14 @@ class _WebCameraPreviewState extends ConsumerState<_WebCameraPreview> {
       return const ScanNotice(
         title: 'Web model unavailable',
         message:
-            'The scanner model could not be loaded by the browser. Check CORS or the public model URL.',
+            'Camera reading could not start right now. Please try again later.',
         kind: ScanNoticeKind.error,
       );
     }
     if (raw.contains('tensor') || raw.contains('shape')) {
       return const ScanNotice(
-        title: 'Model not compatible',
-        message:
-            'This model output does not match the web scanner parser. Use a YOLO TFLite model with the expected class order.',
+        title: 'Scanner unavailable',
+        message: 'Camera reading is not available for this setup yet.',
         kind: ScanNoticeKind.error,
       );
     }
diff --git a/test/features/home/presentation/screens/model_setup_screen_test.dart b/test/features/home/presentation/screens/model_setup_screen_test.dart
index c08df33..b0088f2 100644
--- a/test/features/home/presentation/screens/model_setup_screen_test.dart
+++ b/test/features/home/presentation/screens/model_setup_screen_test.dart
@@ -8,6 +8,7 @@ import 'package:kudlit_ph/features/home/presentation/providers/app_preferences_p
 import 'package:kudlit_ph/features/home/presentation/providers/model_setup_controller.dart';
 import 'package:kudlit_ph/features/home/presentation/screens/model_setup_screen.dart';
 import 'package:kudlit_ph/features/scanner/presentation/providers/yolo_model_selection_provider.dart';
+import 'package:kudlit_ph/features/translator/data/datasources/local_gemma_datasource.dart';
 import 'package:kudlit_ph/features/translator/presentation/providers/ai_inference_provider.dart';
 import 'package:kudlit_ph/features/translator/presentation/providers/ai_inference_state.dart';
 import 'package:kudlit_ph/features/translator/presentation/providers/translator_providers.dart';
@@ -80,9 +81,10 @@ void main() {
   });
 
   test(
-    'complete setup reuses scanner status and keeps cloud mode allowed',
+    'complete setup requires offline downloads and enables local mode',
     () async {
       int statusReads = 0;
+      int readinessReads = 0;
       final ProviderContainer container = ProviderContainer(
         overrides: <Override>[
           visionModelSetupStatusProvider.overrideWith((Ref ref) async {
@@ -94,15 +96,18 @@ void main() {
             );
           }),
           localModelReadinessProvider.overrideWith((Ref ref) async {
-            throw StateError('Cloud setup should not require local Gemma.');
+            readinessReads++;
+            return const LocalGemmaReadiness(
+              installed: true,
+              usable: true,
+              detail: 'Offline ready.',
+            );
           }),
         ],
       );
       addTearDown(container.dispose);
 
       await container.read(appPreferencesNotifierProvider.future);
-      await container.read(visionModelSetupStatusProvider.future);
-
       await container
           .read(modelSetupControllerProvider.notifier)
           .completeSetup();
@@ -111,7 +116,8 @@ void main() {
         appPreferencesNotifierProvider.future,
       );
       expect(statusReads, 1);
-      expect(prefs.aiPreference, AiPreference.cloud);
+      expect(readinessReads, 1);
+      expect(prefs.aiPreference, AiPreference.local);
       expect(prefs.hasDownloadedModels, isTrue);
       expect(container.read(modelSetupControllerProvider).errorMessage, isNull);
     },
diff --git a/test/features/home/presentation/widgets/ai_models_section_test.dart b/test/features/home/presentation/widgets/ai_models_section_test.dart
index dd6fe37..80817fc 100644
--- a/test/features/home/presentation/widgets/ai_models_section_test.dart
+++ b/test/features/home/presentation/widgets/ai_models_section_test.dart
@@ -20,7 +20,7 @@ void main() {
     SharedPreferences.setMockInitialValues(<String, Object>{});
   });
 
-  testWidgets('AI models section frames local setup as a clear destination', (
+  testWidgets('offline downloads section frames setup in plain language', (
     tester,
   ) async {
     await tester.binding.setSurfaceSize(const Size(360, 740));
@@ -37,16 +37,23 @@ void main() {
     await tester.pump();
     await tester.pump();
 
-    expect(find.text('Local AI setup'), findsOneWidget);
+    expect(find.text('OFFLINE DOWNLOADS'), findsOneWidget);
+    expect(find.text('Use Kudlit offline'), findsOneWidget);
     expect(
-      find.text('Install once for offline Butty and scanner setup.'),
+      find.text(
+        'Set these up once to keep replies and camera reading available without internet.',
+      ),
+      findsOneWidget,
+    );
+    expect(find.text('Butty replies'), findsOneWidget);
+    expect(find.text('Offline help  ·  large download'), findsOneWidget);
+    expect(find.text('Needs download'), findsWidgets);
+    expect(find.text('Camera reading'), findsOneWidget);
+    expect(find.text('Reads Baybayin with your camera'), findsOneWidget);
+    expect(
+      find.text('Download once before using camera reading.'),
       findsOneWidget,
     );
-    expect(find.text('Gemma 4 E2B'), findsOneWidget);
-    expect(find.text('Ready for local Butty replies.'), findsOneWidget);
-    expect(find.text('KudVis-1-Turbo'), findsOneWidget);
-    expect(find.text('Local scanner recognition'), findsOneWidget);
-    expect(find.text('Download once before live recognition.'), findsOneWidget);
     expect(tester.takeException(), isNull);
   });
 
@@ -68,7 +75,7 @@ void main() {
     await tester.pump();
     await tester.pump();
 
-    await tester.tap(find.text('Download'));
+    await tester.tap(find.text('Set up'));
     await tester.pump();
     await tester.pump(const Duration(milliseconds: 50));
 
@@ -120,10 +127,9 @@ void main() {
     await tester.pump();
     await tester.pump();
 
-    expect(find.text('KudVis-Pro ready'), findsOneWidget);
-    expect(find.text('KudVis-1-Turbo ready'), findsNothing);
+    expect(find.text('Ready to scan'), findsOneWidget);
 
-    await tester.tap(find.text('Re-download'));
+    await tester.tap(find.text('Set up again'));
     await tester.pump();
     await tester.pump(const Duration(milliseconds: 50));
 
@@ -157,10 +163,10 @@ void main() {
     await tester.pump();
 
     final Rect supportText = tester.getRect(
-      find.text('Download once before live recognition.'),
+      find.text('Download once before using camera reading.'),
     );
     final Rect downloadButton = tester.getRect(
-      find.widgetWithText(ProfileManagementActionButton, 'Download'),
+      find.widgetWithText(ProfileManagementActionButton, 'Set up'),
     );
 
     expect(downloadButton.top, greaterThan(supportText.bottom));
@@ -196,8 +202,8 @@ void main() {
     await tester.pump();
     await tester.pump();
 
-    expect(find.text('Local AI setup'), findsOneWidget);
-    expect(find.text('Setup needed'), findsWidgets);
+    expect(find.text('Use Kudlit offline'), findsOneWidget);
+    expect(find.text('Needs download'), findsWidgets);
     expect(find.byType(ProfileManagementActionButton), findsWidgets);
     expect(tester.takeException(), isNull);
   });
diff --git a/test/features/scanner/data/datasources/web_yolo_output_parser_test.dart b/test/features/scanner/data/datasources/web_yolo_output_parser_test.dart
index 5d1ae9c..6738dfb 100644
--- a/test/features/scanner/data/datasources/web_yolo_output_parser_test.dart
+++ b/test/features/scanner/data/datasources/web_yolo_output_parser_test.dart
@@ -65,7 +65,7 @@ void main() {
     expect(detections.single.confidence, closeTo(0.72, 0.001));
   });
 
-  test('parses 2D YOLOv12 output shape into detections', () {
+  test('parses 2D web model output shape into detections', () {
     final List<BaybayinDetection> detections = parser.parse(
       <double>[
         0.5,
diff --git a/test/features/scanner/presentation/widgets/scanner_camera_status_test.dart b/test/features/scanner/presentation/widgets/scanner_camera_status_test.dart
index 36b9825..9200d3a 100644
--- a/test/features/scanner/presentation/widgets/scanner_camera_status_test.dart
+++ b/test/features/scanner/presentation/widgets/scanner_camera_status_test.dart
@@ -177,20 +177,20 @@ void main() {
     expect(find.text('Scanner model needs setup'), findsOneWidget);
     expect(
       find.text(
-        'Open Settings > AI models to install or update scanner models.',
+        'Open Settings > Offline downloads to get camera reading ready.',
       ),
       findsOneWidget,
     );
-    expect(find.text('Open AI models'), findsOneWidget);
+    expect(find.text('Open downloads'), findsOneWidget);
     expect(find.text('Try Again'), findsOneWidget);
     expect(find.textContaining('Exception'), findsNothing);
 
     final Rect ctaRect = tester.getRect(
-      find.widgetWithText(FilledButton, 'Open AI models'),
+      find.widgetWithText(FilledButton, 'Open downloads'),
     );
     expect(ctaRect.height, greaterThanOrEqualTo(44));
 
-    await tester.tap(find.text('Open AI models'));
+    await tester.tap(find.text('Open downloads'));
     expect(openedSettings, isTrue);
     expect(tester.takeException(), isNull);
   });

From b6278caa839e8e693cbbf3822678e4290c1bc98f Mon Sep 17 00:00:00 2001
From: JamTheDev <2004jamvillarosa@gmail.com>
Date: Mon, 11 May 2026 14:51:33 +0800
Subject: [PATCH 5/5] fix: show vision model name

---
 .../screens/model_setup_screen.dart             |  8 ++++----
 .../butty_chat/butty_model_mode_selector.dart   |  4 ++--
 .../widgets/settings/llm_download_tile.dart     |  8 ++++----
 .../settings/local_model_status_row.dart        |  6 +++---
 .../widgets/settings/vision_download_tile.dart  | 17 +++++++++++++----
 .../widgets/ai_models_section_test.dart         |  5 +++--
 6 files changed, 29 insertions(+), 19 deletions(-)

diff --git a/lib/features/home/presentation/screens/model_setup_screen.dart b/lib/features/home/presentation/screens/model_setup_screen.dart
index aa70588..390f752 100644
--- a/lib/features/home/presentation/screens/model_setup_screen.dart
+++ b/lib/features/home/presentation/screens/model_setup_screen.dart
@@ -52,7 +52,7 @@ class _ModelSetupScreenState extends ConsumerState<ModelSetupScreen> {
   String _friendlyModelSetupError(String rawMessage) {
     final String message = rawMessage.trim();
     if (message.isEmpty) {
-      return 'Offline setup is paused. You can keep using online help and try again later.';
+      return 'Offline setup is paused. You can stay on internet mode and try again later.';
     }
 
     final String lower = message.toLowerCase();
@@ -73,7 +73,7 @@ class _ModelSetupScreenState extends ConsumerState<ModelSetupScreen> {
     }
 
     if (lower.contains('no ai models configured')) {
-      return 'Offline downloads are not available right now. You can keep using online help for now.';
+      return 'Offline downloads are not available right now. You can stay on internet mode for now.';
     }
 
     final bool looksTechnical =
@@ -84,7 +84,7 @@ class _ModelSetupScreenState extends ConsumerState<ModelSetupScreen> {
         lower.contains('uri=') ||
         lower.contains('https://');
     if (looksTechnical) {
-      return 'Offline setup is paused. You can keep using online help and try again later.';
+      return 'Offline setup is paused. You can stay on internet mode and try again later.';
     }
 
     return message;
@@ -494,7 +494,7 @@ class _SetupActions extends StatelessWidget {
             disabledForegroundColor: KudlitColors.grey500,
           ),
           child: const Text(
-            'Not now - use online help',
+            'Not now - stay on internet mode',
             style: TextStyle(fontSize: 14, fontWeight: FontWeight.w600),
           ),
         ),
diff --git a/lib/features/home/presentation/widgets/butty_chat/butty_model_mode_selector.dart b/lib/features/home/presentation/widgets/butty_chat/butty_model_mode_selector.dart
index 7dde0c8..c363560 100644
--- a/lib/features/home/presentation/widgets/butty_chat/butty_model_mode_selector.dart
+++ b/lib/features/home/presentation/widgets/butty_chat/butty_model_mode_selector.dart
@@ -56,8 +56,8 @@ class ButtyModelModeSelector extends ConsumerWidget {
       AsyncData(:final ButtyOfflineStatus value) =>
         value.detail ?? 'Offline status unknown.',
       AsyncError() =>
-        'Offline check failed. Use online help or try again later.',
-      _ => 'Checking whether offline help is ready…',
+        'Offline check failed. Stay on internet mode or try again later.',
+      _ => 'Checking whether offline replies are ready…',
     };
 
     final Widget pills = Container(
diff --git a/lib/features/home/presentation/widgets/settings/llm_download_tile.dart b/lib/features/home/presentation/widgets/settings/llm_download_tile.dart
index 1895c37..7031c18 100644
--- a/lib/features/home/presentation/widgets/settings/llm_download_tile.dart
+++ b/lib/features/home/presentation/widgets/settings/llm_download_tile.dart
@@ -36,7 +36,7 @@ class LlmDownloadTile extends ConsumerWidget {
           const _TileHeader(
             icon: Icons.psychology_rounded,
             label: 'Butty replies',
-            sublabel: 'Offline help  ·  large download',
+            sublabel: 'Offline replies  ·  large download',
           ),
           const SizedBox(height: 10),
           _LlmStatusRow(
@@ -373,7 +373,7 @@ class _ErrRow extends StatelessWidget {
 String _friendlyLlmModelError(String rawMessage) {
   final String message = rawMessage.trim();
   if (message.isEmpty) {
-    return 'Offline setup is paused. You can keep using online help and try again later.';
+    return 'Offline setup is paused. You can stay on internet mode and try again later.';
   }
 
   final String lower = message.toLowerCase();
@@ -394,7 +394,7 @@ String _friendlyLlmModelError(String rawMessage) {
   }
 
   if (lower.contains('no ai models configured')) {
-    return 'Offline downloads are not available right now. You can keep using online help for now.';
+    return 'Offline downloads are not available right now. You can stay on internet mode for now.';
   }
 
   final bool looksTechnical =
@@ -405,7 +405,7 @@ String _friendlyLlmModelError(String rawMessage) {
       lower.contains('uri=') ||
       lower.contains('https://');
   if (looksTechnical) {
-    return 'Offline setup is paused. You can keep using online help and try again later.';
+    return 'Offline setup is paused. You can stay on internet mode and try again later.';
   }
 
   return message;
diff --git a/lib/features/home/presentation/widgets/settings/local_model_status_row.dart b/lib/features/home/presentation/widgets/settings/local_model_status_row.dart
index 87a30e9..dc63185 100644
--- a/lib/features/home/presentation/widgets/settings/local_model_status_row.dart
+++ b/lib/features/home/presentation/widgets/settings/local_model_status_row.dart
@@ -55,7 +55,7 @@ class _StatusContent extends ConsumerWidget {
       AiReady(:final AiPreference mode) =>
         mode == AiPreference.cloud
             ? Text(
-                'Online help is active. Offline download is optional.',
+                'Internet mode is active. Offline download is optional.',
                 style: TextStyle(
                   color: cs.onSurface.withAlpha(150),
                   fontSize: 13,
@@ -78,7 +78,7 @@ class _StatusContent extends ConsumerWidget {
               const SizedBox(width: 6),
               Expanded(
                 child: Text(
-                  'Offline help is not downloaded yet.',
+                  'Offline replies are not downloaded yet.',
                   style: TextStyle(color: cs.error, fontSize: 13),
                 ),
               ),
@@ -139,7 +139,7 @@ class _StatusContent extends ConsumerWidget {
         style: TextStyle(color: cs.error, fontSize: 13),
       ),
       _ => Text(
-        'Getting offline help ready…',
+        'Getting offline replies ready…',
         style: TextStyle(color: cs.onSurface.withAlpha(150), fontSize: 13),
       ),
     };
diff --git a/lib/features/home/presentation/widgets/settings/vision_download_tile.dart b/lib/features/home/presentation/widgets/settings/vision_download_tile.dart
index f5913f0..f56b3dc 100644
--- a/lib/features/home/presentation/widgets/settings/vision_download_tile.dart
+++ b/lib/features/home/presentation/widgets/settings/vision_download_tile.dart
@@ -80,13 +80,20 @@ class _VisionDownloadTileState extends ConsumerState<VisionDownloadTile> {
     final AsyncValue<AiModelInfo?> activeModelAsync = ref.watch(
       activeYoloModelProvider(YoloModelScope.camera),
     );
+    final List<AiModelInfo>? availableModels = modelsAsync.asData?.value;
+    final AiModelInfo? activeModel = activeModelAsync.asData?.value;
+    final String headerLabel =
+        activeModel?.name ??
+        ((availableModels != null && availableModels.isNotEmpty)
+            ? availableModels.first.name
+            : 'Scanner model');
 
     return Padding(
       padding: const EdgeInsets.symmetric(horizontal: 16, vertical: 14),
       child: Column(
         crossAxisAlignment: CrossAxisAlignment.start,
         children: <Widget>[
-          const _VisionTileHeader(),
+          _VisionTileHeader(label: headerLabel),
           const SizedBox(height: 10),
           modelsAsync.when(
             loading: () => const _CheckingRow(),
@@ -282,7 +289,9 @@ class _DownloadProgressRow extends StatelessWidget {
 }
 
 class _VisionTileHeader extends StatelessWidget {
-  const _VisionTileHeader();
+  const _VisionTileHeader({required this.label});
+
+  final String label;
 
   @override
   Widget build(BuildContext context) {
@@ -297,7 +306,7 @@ class _VisionTileHeader extends StatelessWidget {
             crossAxisAlignment: CrossAxisAlignment.start,
             children: <Widget>[
               Text(
-                'Camera reading',
+                label,
                 maxLines: 1,
                 overflow: TextOverflow.ellipsis,
                 style: TextStyle(
@@ -308,7 +317,7 @@ class _VisionTileHeader extends StatelessWidget {
               ),
               Text(
                 kIsWeb
-                    ? 'Reads Baybayin in this browser'
+                    ? 'Baybayin camera reading in this browser'
                     : 'Reads Baybayin with your camera',
                 maxLines: 2,
                 overflow: TextOverflow.ellipsis,
diff --git a/test/features/home/presentation/widgets/ai_models_section_test.dart b/test/features/home/presentation/widgets/ai_models_section_test.dart
index 80817fc..4bdea55 100644
--- a/test/features/home/presentation/widgets/ai_models_section_test.dart
+++ b/test/features/home/presentation/widgets/ai_models_section_test.dart
@@ -46,9 +46,9 @@ void main() {
       findsOneWidget,
     );
     expect(find.text('Butty replies'), findsOneWidget);
-    expect(find.text('Offline help  ·  large download'), findsOneWidget);
+    expect(find.text('Offline replies  ·  large download'), findsOneWidget);
     expect(find.text('Needs download'), findsWidgets);
-    expect(find.text('Camera reading'), findsOneWidget);
+    expect(find.text('KudVis-1-Turbo'), findsOneWidget);
     expect(find.text('Reads Baybayin with your camera'), findsOneWidget);
     expect(
       find.text('Download once before using camera reading.'),
@@ -127,6 +127,7 @@ void main() {
     await tester.pump();
     await tester.pump();
 
+    expect(find.text('KudVis-Pro'), findsOneWidget);
     expect(find.text('Ready to scan'), findsOneWidget);
 
     await tester.tap(find.text('Set up again'));