Airgap

React Native starter kit

Customer support that keeps working when the network does not.

Airgap combines local knowledge retrieval, visible answer sources, on-device generation, and a durable action outbox. Start in demo mode with no model download or network request.

Demo Local Cloud Offline

Build a telco support app from the checked source package

npx create-airgap-bot support-app --template telco
Install from source Read the roadmap
Airgap running a customer support conversation on Android

MITlicensed

8industry templates

Android + iOSReact Native targets

Ed25519Signed knowledge updates

Philippine public-service tools

Ask a question. Check what answered.

Try eight dated public-service records and 26 maintainer-written test cases in the Evidence Lab. Live questions use the same deterministic core as the CLI and government mobile path. Model results are separately labeled recorded host runs. No agency transactions are connected.

First run and replay

From a checkout, use Node 22.18 or newer and Python 3:

npm ci
node scripts/public-service.mjs replay --json
npm run public:build
python3 -m http.server --bind 127.0.0.1 --directory web 8080

Open http://127.0.0.1:8080/lab.html.

Read the setup, evidence and contribution guide for source dates, measured limits and how to add a sourced case.

Reproduce all five recordings

npm run public:demo -- --model /path/to/gemma-3-1b-it.gguf

Requires committed source, FFmpeg and a compatible local model. The kit checks dependencies, runs the experiment and exports browser GIFs and MP4s. Review each full loop before sharing it. No API key is required.

PH Public-Service Replay Pack

Run all 26 cases in order, including the 18 government golden queries. Check answers, routes and exact source hashes. Prompts are maintainer-written tests, not citizen reports.

Watch replay GIF · Replay MP4

Evidence Lab: break Kuya B, the sample government assistant

Type a question, ask a doubt follow-up, inspect the source excerpt and download reusable case JSON. Unsupported details refuse; agency requests report unavailable.

Try the lab · Watch lab GIF · Lab MP4

Source Update Workbench

Compare the 2024 Ninoy Aquino Day amendment, review its authorities, apply it locally and roll back. Historical records cannot answer current holiday questions.

Watch source update GIF · Source update MP4

Model and Controls Experiment

Inspect all 63 recorded results from seven questions and three repetitions per variant. The Gemma 3 CPU host run made 42 model calls; all 21 controlled answers fell back to records. Measurements cover this CPU host and these seven questions.

Watch model results GIF · Model results MP4

Reproducible Demo Kit

Run setup, replay, local inference, browser checks and capture with one command. Export five GIFs and MP4s with source, code, model and timing evidence. Raw footage stays local.

Watch demo kit GIF · Demo kit MP4

How it works

One support path, with each boundary visible.

The app retrieves local documents before it generates an answer. Network actions and content updates use separate authenticated paths.

  1. 01

    Retrieve

    MiniSearch selects relevant local documents from the active template.

  2. 02

    Respond

    Demo, local, or cloud generation uses the same grounded context.

  3. 03

    Explain

    The conversation shows its source, knowledge version, and evidence.

  4. 04

    Recover

    Network actions wait in an encrypted outbox with Retry and Remove controls.

Included templates

Change the domain, not the runtime.

Each template includes its own brand, support prompts, tools, safety rules, and local knowledge documents.

The details and recorded Android flow update below.

Template facts

Company
Assistant
Purpose
Region
Documents
Tools

    Recorded Android flow

    Captured from the mobile app with the selected template configuration.

    Configuration excerpt

    Production boundary

    Useful defaults without hidden infrastructure claims.

    Airgap supplies the mobile client and a reference Node server. An operator still owns identity, authorization, model hosting, monitoring, and the systems that perform account changes.

    Checked in the repository

    • Platform-protected keys for encrypted app stores
    • Exact hash and Ed25519 checks before knowledge swaps
    • Fresh access tokens for authenticated requests
    • Bounded request bodies and reference rate limits

    Required from an operator

    • An access-token provider and authorization policy
    • Private signing keys and a trusted model source
    • A production backend for real account actions
    • Device, accessibility, security, and domain validation

    Start with the offline demo

    Inspect the code, run the tests, then connect your systems.

    Open the repository