Getting started¶
Adaptive Learner is a learning companion built on a research-backed six-method model. You take a short test that finds out which methods suit you, then run AI-assisted learning sessions through a seven-step cycle. The app learns with you and adapts how it teaches.
Try it now¶
The fastest way to get to know Adaptive Learner is the public online version:
It runs in local mode — all your data stays in your browser (IndexedDB), and AI calls go straight from the page to Anthropic, OpenAI or Google Gemini using your own API key. No backend in between.
Install as a Progressive Web App¶
Adaptive Learner is installable, and the way you install it depends on your platform:
- Android & desktop (Chrome / Edge): the browser fires an install prompt, which the app turns into a discreet, dismissable "Install app" banner (re-offered after 7 days if you dismiss it). You can also install any time from Settings → Data → Install app.
- iPhone / iPad (Safari): iOS has no automatic install prompt, so Adaptive Learner shows a small "Add to Home Screen" hint instead: tap the Share button, then "Add to Home Screen". The hint appears only on iOS Safari and only while the app is not yet installed — once installed it never shows again.
Either way, Adaptive Learner becomes a standalone app on your phone or desktop, launchable without a browser tab. (When it is already running as an installed app, none of the install hints appear.)
The app works offline for the Dashboard and past sessions. New AI sessions need the internet, because the AI provider lives outside the browser.
What you need¶
- A modern browser (Chrome 100+, Firefox 100+, Safari 17+, Edge 100+). The app uses IndexedDB, service workers and modern JavaScript.
- An AI API key for at least one of the three supported providers (Anthropic, OpenAI or Google Gemini). The free tiers are usually enough to get started; see Settings for key setup.
The first five minutes¶
- Open the app and choose a language. All 11 UI languages are fully translated (DE, EL, EN, ES, FR, HI, ID, JA, KO, PT, TR).
- Onboarding: only name + topic. The quick start asks for just these two fields, everything else takes defaults. Afterwards you can choose "Jump right in" or optionally set up your profile in more detail in the wizard. See Onboarding.
- Start your first lesson — the fastest way without an AI
key: open the
Content Browser at
/content, choose a lesson set and start a lesson. You read short theory and do exercises; at the end you see your result with stars. See Lessons and reviews. Tip: the best place to begin is the bundled set "Adaptive Learner — App-Tutorial", which teaches you the app directly as lessons. See App tutorial. - Optional: AI sessions. If you would rather have the guided
six-method learning conversation, store an API key
(Settings or
~/.config/adaptive-learner/secrets.yaml), take the optional learning-style assessment and start a learning session. - Save your result. From the lesson summary you can copy the result as Markdown or save it as a file, and under Settings → Data create a backup.
Bring your own AI key¶
Adaptive Learner is bring-your-own-key (BYOK). When no key is set, the Dashboard shows a single inviting "add your AI key" card that leads to the AI settings. Add a key for Claude, OpenAI or Gemini to unlock the AI-powered features (tutor session, chat analysis, exercise generation). Your keys are stored locally on your device.
Where to go next¶
- App tutorial — practice the app inside the app (no AI key needed)
- Lessons and reviews — the lesson flow in detail
- Content Browser — find and filter lessons
- Multiple content repositories — connect your own content sources
- Backup and restore
- Understanding your Dashboard — progress, streak, XP, badges
- FAQ — frequently asked questions
- The pedagogical idea behind the app