Guides
Getting started Configuration Supabase setup Sync & backup Backup console CommunityReference
Architecture API reference Database CLI Android APK Admin consoleHelp
Troubleshooting FAQ Contributing ChangelogLegal
Security Privacy Terms Licensev3.4.1MIT licensedself-hosted
IsotopeAI is a local-first study platform for JEE, NEET and Board students. The server runs on your device. Your data lives in your own Supabase project. No tenant, no subscription, no telemetry.
A single Node process serves the app, proxies Supabase, and patches the frontend bundles at request time. Android via Termux is a first-class target, not an afterthought.
# clone and set up $ git clone https://github.com/Suydev/isotope-code $ cd isotope-code && ./setup.sh # start the local server $ isotope start → http://127.0.0.1:3000
Study tooling, plus the infrastructure to keep it yours.
Sessions write to Postgres, not just localStorage. Streaks, per-subject totals and daily aggregates are computed server-side, so the numbers survive a reinstall. Picture-in-Picture keeps the timer visible while you work in other apps.
Chapter-level progress across subjects, with availability rules.
Mock tests, countdowns and accuracy trends per subject.
Group membership, realtime chat, invite links and presence — all enforced
by row-level security in your own database, using
SECURITY DEFINER functions with pinned search paths.
Version + content-hash resolution. Rich data never loses to an empty snapshot.
Service worker shell with an app-shell fallback and a real offline page.
Written against the running system — every route, table and command verified against the live build.
Install on Android, Linux, macOS or Windows. First run and first login.
Read guide →Every environment variable, what reads it, and which are safe to share.
Read guide →Create the project, run the schema, configure buckets and RLS.
Read guide →Serve-time bundle patching, request flow, and the service worker cache.
Read reference →Every local route with auth requirements, status codes and payloads.
Read reference →All 42 tables, 80 functions, 153 RLS policies and 15 triggers.
Read reference →There is no IsotopeAI server. The app talks to a Node process on your own machine, which talks to a Supabase project you created and control. The service-role key never reaches the browser, and nothing is reported anywhere.