Offline-first AI health companion powered by Google's Gemma 4 4B running entirely on-device. Multi-agent specialist routing, drug lookup, symptom triage, nearby doctor search, and Firebase-backed cloud sync — all in a single React Native app for Android and iOS.

YouTube Video

Screenshots

Splash Screen

Sign In

Model Download

Home Dashboard

Lab Report Analysis

AI Response

Skin Lesion Analysis

Hindi Language Support

Chat Reports

Generated Report

PDF Patient Summary

PDF Clinical Report

Health Insights

Insight Detail

Navigation Menu

Drug Search

Drug Detail

Affordable Alternatives

Nearby Doctors

On-Device AI

System Architecture

High-Level Design (HLD)

Data flow between the Mobile Client, AI Orchestrator, Inference Engines, and SQLite/Firebase Data Layer.

Low-Level Design (LLD)

The 5-step sequence flow of a user query being routed and processed by the AI Orchestrator and Specialists.

Features

On-Device AI — No Internet Required

• Gemma 4 4B (IQ2_M) runs fully on-device via llama.rn (GGUF format)
• ~1.5 GB model, ~2 GB RAM — works offline after one-time download
• Zero data sent to external servers during inference
• Cloud AI (Gemini) used as fallback when online

Multi-Agent Specialist System

• 46 specialist agents — each with domain-specific system prompts and tool access
• Central orchestrator auto-detects intent and routes to the right specialist(s)
• Up to 3 agents collaborate on complex multi-system queries
• Real-time routing info (agent name + response time) shown in every message

Health Tools

• Drug Info — Search 1mg medicine database (name, dosage, warnings, interactions)
• Affordable Alternatives — Find cheaper generic substitutes with price comparison
• First Aid Guide — Step-by-step emergency guidance
• Find Nearby Doctors — Location-based doctor and hospital search
• Image Analysis — Analyze wound, rash, or medical images via camera/gallery
• Health Metrics — Track vitals (BP, glucose, weight) over time
• Medication Reminders — Local notifications for medication schedules
• Chat Reports — Export conversation summaries as PDF

Privacy & Sync

• All AI inference runs on-device — no health data leaves your phone
• SQLite local database for all chats, profiles, and history
• Firebase Firestore optional cloud sync with incremental pull + outbox pattern
• Biometric authentication (fingerprint/face) for app lock

UI/UX

• Light and Dark mode
• Markdown rendering in AI responses
• Animated splash screen
• Search history across drug lookups and AI queries

Tech Stack

Setup

Prerequisites

• Node.js >= 18
• React Native CLI
• Android Studio (API 33+) or Xcode 15+
• Firebase project with Auth and Firestore enabled

1. Clone and install

git clone https://github.com/narender-rk10/AI-CareCompanion-Offline-Health-By-Gemma.git
cd AI-CareCompanion-Offline-Health-By-Gemma
npm install

2. iOS pods

cd ios && pod install && cd ..

3. Firebase configuration

1. Create a project at console.firebase.google.com
2. Enable Authentication → Email/Password
3. Enable Firestore Database
4. Download google-services.json → place in android/app/
5. Download GoogleService-Info.plist → add to Xcode project

4. Environment variables

cp .env.example .env

Then fill in .env:

# Gemini API key — https://aistudio.google.com/app/apikey
GEMINI_API_KEY=your_gemini_api_key_here

# Google Sign-In Web Client ID (Firebase Console → Auth → Google → Web SDK config)
GOOGLE_WEB_CLIENT_ID=your_google_web_client_id.apps.googleusercontent.com

# Direct GGUF download URL for Gemma 4 4B (~1.5 GB)
MODEL_DOWNLOAD_URL=https://huggingface.co/your-org/model/resolve/main/model.gguf

Firebase credentials go in android/app/google-services.json and ios/GoogleService-Info.plist — not in .env.

5. Run

# Android
npm run android

# iOS
npm run ios

6. Download the AI model

On first launch, the app will prompt you to download Gemma 4 4B (~1.5 GB). Requires a stable Wi-Fi connection and ~3 GB free storage. After download the model runs fully offline.

Project Structure

src/
├── components/          # Reusable UI components
│   ├── ui/              # AppButton, AppInput, AppCard, ScreenHeader
│   ├── ChatBubble.tsx
│   ├── BiometricGate.tsx
│   ├── MarkdownText.tsx
│   └── SyncStatusBar.tsx
├── screens/             # All app screens
│   ├── ChatScreen.tsx               # Main AI chat
│   ├── HomeScreen.tsx               # Dashboard
│   ├── DrugInfoScreen.tsx           # Medicine search
│   ├── AffordableAlternativesScreen.tsx
│   ├── FirstAidGuideScreen.tsx
│   ├── FindNearbyDoctorScreen.tsx
│   ├── ImageAnalysisScreen.tsx
│   ├── AgentSelectorScreen.tsx
│   ├── ChatReportsScreen.tsx
│   ├── SettingsScreen.tsx
│   └── ...
├── services/            # Business logic
│   ├── LlmService.ts              # Gemini cloud AI
│   ├── LocalLlmService.ts         # llama.rn on-device AI
│   ├── AgentService.ts            # Multi-agent orchestration
│   ├── ModelManager.ts            # Model download & lifecycle
│   ├── DatabaseService.ts         # SQLite wrapper
│   ├── FirebaseService.ts         # Auth + Firestore sync
│   ├── DrugInfoService.ts         # 1mg medicine DB
│   └── PlaceSearchService.ts      # Nearby doctor search
├── context/
│   └── HealthProfileContext.tsx   # Global health profile state
├── navigation/
│   └── AppNavigator.tsx           # Auth flow + tab navigation
└── theme/                         # Colors, typography, dark mode

Demo Prompts

"I have chest pain and shortness of breath"
"What is the dosage for metformin 500mg?"
"My child has had a fever for 3 days"
"Find a cardiologist near me"
"What are affordable alternatives to Crocin?"
"Analyze this rash on my arm" (attach photo)

Privacy

• AI inference is 100% on-device when using the offline model
• Health profile and chat history stored only in local SQLite by default
• Firebase sync is opt-in — no data uploaded without user action
• Biometric lock prevents unauthorized access

License

Copyright (c) 2026 Narender Keswani. All Rights Reserved.

This project is proprietary software. You may view the source code for personal reference, but you may not copy, distribute, modify, or use it commercially without explicit written permission.

See LICENSE for full terms.

Built for people who need reliable health guidance anywhere — with or without internet.