AI CareCompanion - Offline Health Assistant

NARENDER KESWANI — Sat, 23 May 2026 16:59:32 +0000

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

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

#	Agent	Specialty	Image Support
1	Triage Assistant	Orchestrator — intent detection & routing	✓
2	General Health Specialist	General Practice
3	Child Health Specialist	Paediatrics
4	Chronic Care Specialist	Internal Medicine
5	Heart Health Specialist	Cardiology
6	Skin Care Specialist	Dermatology	✓
7	Brain & Nerve Specialist	Neurology
8	Digestive Health Specialist	Gastroenterology
9	Lung & Breathing Specialist	Pulmonology
10	Kidney Specialist	Nephrology
11	Hormone Specialist	Endocrinology
12	Infection Specialist	Infectious Disease
13	Women's Health Specialist	Obstetrics & Gynecology
14	Bone & Muscle Specialist	Orthopaedics
15	Eye Care Specialist	Ophthalmology
16	Ear, Nose & Throat Specialist	ENT
17	Mental Health Specialist	Psychiatry
18	Dental Care Specialist	Dentistry
19	Urinary Tract Specialist	Urology
20	Blood Specialist	Haematology
21	Joint & Immune Specialist	Rheumatology
22	Allergy Specialist	Allergy & Immunology
23	Newborn Care Specialist	Neonatology
24	Senior Health Specialist	Geriatrics
25	Emergency Care Specialist	Emergency Medicine
26	Nutrition & Diet Specialist	Nutrition & Dietetics
27	Medication Specialist	Pharmacy
28	Radiology & Imaging Specialist	Radiology	✓
29	Sports Medicine Specialist	Sports Medicine
30	Sleep Medicine Specialist	Sleep Medicine
31	Palliative & Hospice Care Specialist	Palliative Care
32	Rehabilitation Specialist	Physiatry / Rehab Medicine
33	Genetics & Genomics Specialist	Genetics
34	Pain Management Specialist	Pain Management
35	Toxicology & Poisoning Specialist	Toxicology
36	Travel Medicine Specialist	Travel Medicine
37	Adolescent Medicine Specialist	Adolescent Medicine
38	Reproductive & Fertility Specialist	Fertility
39	Vascular Medicine Specialist	Vascular Medicine
40	Transplant Medicine Specialist	Transplant Medicine
41	Clinical Pathology Specialist	Pathology
42	Integrative Medicine Specialist	Integrative Medicine
43	Addiction Medicine Specialist	Addiction Medicine
44	Occupational Medicine Specialist	Occupational Medicine
45	Lifestyle Medicine Specialist	Lifestyle Medicine
46	Preventive Medicine Specialist	Preventive Medicine

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

Layer	Technology
Framework	React Native 0.76 (TypeScript)
On-Device AI	llama.rn — Gemma 4 4B IQ2_M GGUF
Cloud AI	Google Gemini (online fallback)
Auth	Firebase Auth (Email/Password + email verification)
Local DB	SQLite via react-native-sqlite-storage
Cloud Sync	Firebase Firestore
Navigation	React Navigation v7
Biometrics	react-native-biometrics

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

Create a project at console.firebase.google.com
Enable Authentication → Email/Password
Enable Firestore Database
Download google-services.json → place in android/app/
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

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.

DEV Community: NARENDER KESWANI