DenialShield: Automated Medical Denial Rebuttal Assistant

DenialShield is an Android application designed to help patients and caregivers generate clear, structured, and legally sound responses to medical claim denials.

Disclaimer

DenialShield does not provide legal, medical, or other advice to any patient or insurer. The app exists only to demonstrate on-device AI workflows and should not be used in real-world scenarios. Use at your own risk; the authors accept no responsibility or liability for any use of this software.

Features

• Step-by-step Denial Intake: A guided workflow to capture claim and provider details.
• AI-Powered Rebuttals: Local-only processing using MediaPipe GenAI for private and professional response generation.
• Document Processing: OCR (ML Kit) for photos and PDF text extraction (PDFBox) to automatically extract policy language.
• Privacy First: All data is processed and stored locally on your device.
• Export Options: Share generated rebuttals via email, PDF, or secure messaging.

Usage

• Initial disclaimer:

• Open the app

• Enter insurance information and personal details

• Enter the denied claim

• Enter basic information about the claim, take the photo or upload the document

• Processing denial documents

• Generating response

• Submit the rebuttal

It's a copy/paste and manual submission..

Tech Stack

• Jetpack Compose: Modern UI implementation.
• Room DB: Local persistent storage.
• MediaPipe GenAI: Local LLM Inference for text generation.
• ML Kit: OCR for image text extraction.
• PDFBox-Android: PDF text processing.
• Kotlin Coroutines & Flow: Asynchronous processing and reactive UI.

Getting Started

1. Clone this repository.
2. Open the project in Android Studio (Ladybug or newer recommended).
3. Sync Project with Gradle Files.
4. AI Generation: On first run, the app downloads a public LiteRT .task model (SmolLM-135M-Instruct) and stores it as model.bin under Android/data/com.denialshield/files/models/. The app provides a fallback template generator if the model is missing or the native runtime is unavailable.

Installation

To install DenialShield on your Android phone:

1. Build the APK: Run ./build or use Android Studio's Build > Build Bundle(s) / APK(s) > Build APK(s).
2. Locate the APK: The file will be at app/build/outputs/apk/debug/app-debug.apk.
3. Install:
   • Via ADB: adb install app/build/outputs/apk/debug/app-debug.apk
   • Manual Transfer: Transfer the .apk file to your phone and open it with a file manager. You may need to enable "Install from Unknown Sources".

For detailed instructions, see the Usage Guide and the Release Guide.

CI APK Artifact

Each push to main produces a signed (if secrets are set) or unsigned release APK and publishes it as the latest release asset:

https://github.com/nikolareljin/denial-shield/releases/download/latest/denial-shield-latest.apk

Privacy Note

DenialShield processes all medical information locally. No sensitive claim data or personal information is transmitted to any cloud servers for rebuttal generation.

License

This project is licensed under a Custom Proprietary License.

• Commercial Use: Only the Creator (Nikola Reljin) is authorized to use this software for commercial purposes. All other commercial use is strictly prohibited.
• Modifications: No modifications are permitted without prior written consent from the Creator.

See the LICENSE file for the full legal terms.