Skip to content

About

Self-study app for physics and maths textbooks. Photograph problems and handwritten solutions; an LLM reads and grades the working, and spaced repetition schedules reviews. Live demo available.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Question Bank

Work through a textbook's problems on paper, and get them checked and brought back until they stick.

Try the demo: no sign-up. It has a small sample library and one handwritten answer you can submit to see it read and graded.

Why it exists

Working through the exercises is the best way to learn from a physics or maths textbook. It has two problems:

  • Nobody checks your work. The answers at the back give a number, not feedback on your reasoning, and many books have no answers at all.
  • You forget. A problem you solved in March is gone by June unless you see it again.

Question Bank turns the problems in a book into a personal question bank. You keep solving on paper. An AI model checks your working, and the app decides when each problem should come back.

How it works

From a printed page to a scheduled review, in nine steps:

Photograph the pages: Two pages of a problem set, shot with a phone at an angle.
1. Photograph the pages. Two pages of a problem set, shot with a phone at an angle.
Figures are found: Each page is flattened and its figures are outlined. You can fix a box by hand.
2. Figures are found. Each page is flattened and its figures are outlined. You can fix a box by hand.
Problems are read off: Text and maths come out as LaTeX, and each figure lands on the problem that cites it.
3. Problems are read off. Text and maths come out as LaTeX, and each figure lands on the problem that cites it.
Maths-heavy pages too: A page of integrals, read from a photo of the sheet held in the air.
4. Maths-heavy pages too. A page of integrals, read from a photo of the sheet held in the air.
Answer on paper: Solve the next problem by hand and photograph your working.
5. Answer on paper. Solve the next problem by hand and photograph your working.
Check the reading: A first agent only reads your handwriting into LaTeX. It is told not to solve, correct or grade.
6. Check the reading. A first agent only reads your handwriting into LaTeX. It is told not to solve, correct or grade.
Get it graded: A second agent critiques the confirmed reading and suggests a rating. You set the final one.
7. Get it graded. A second agent critiques the confirmed reading and suggests a rating. You set the final one.
It comes back: A full mark schedules the problem for review in a week, then a month.
8. It comes back. A full mark schedules the problem for review in a week, then a month.
Keep going: The library tracks progress per book, your day streak and weekly goals.
9. Keep going. The library tracks progress per book, your day streak and weekly goals.

The screenshots are from one real run. The pages in docs/demo were printed, photographed with a phone, scanned by the app, answered by hand and graded.

Grading you can trust

An AI model that solves a problem while it reads your handwriting tends to "see" the answer it expected. Question Bank keeps these jobs apart:

  1. Reading. One model only copies your handwriting into typed maths. It is told not to solve, correct or grade, and you check its reading before anything else happens.
  2. Critique. A second model reviews the reading you confirmed, explains what is right and wrong, and suggests a mark. You can question the critique in a chat.
  3. Your call. You set the final mark: not yet, partly, or fully solved. The model advises, you decide.

What you can do

Build a book

  • Photograph one or several pages, or paste text, and the problems are pulled out with their maths and diagrams.
  • Review what was found before it is added, and ask for changes in a chat.
  • Fix diagram outlines by hand when the automatic cut-out misses.

Solve and get feedback

  • Answer on paper and send a photo. Correct the reading in an editor that shows the maths as you type.
  • Read the critique, discuss it, and set your mark.
  • Skip or snooze problems you don't want right now. Every past attempt is kept.

Keep it

  • A problem you solve fully comes back after a week, then after a month. A partial or wrong answer doesn't move it up; you see it again at the same interval.
  • Learn takes you through new problems in book order. Practice gathers what is due across all your books.
  • Progress per book, a day streak, and weekly goals.

Privacy

  • Photos of your answers are sent to the model to be read and then discarded. They are never stored.
  • Each account's books and answers are kept separate from everyone else's.
  • Works on phone and desktop, and can be installed like an app.

Current limitations

This is an active personal project. Known rough edges:

  • Scanning the same pages twice can number the problems differently. Check the labels when you review a scan.
  • Diagrams are sometimes not attached to their problem automatically. You can attach them from the book's edit page.
  • If the model declines to grade an answer, the app just reports that grading failed and doesn't retry.
  • The demo replays recorded results. Only the provided sample answer can be graded there.

The full list of planned work is in TODO.md.

Running it yourself

See docs/setup.md to run it locally, configure it, or deploy it. Without any accounts or keys, QB_DEMO=1 npm run dev runs the demo on your machine.

License

PolyForm Noncommercial 1.0.0: free for personal and other non-commercial use.

About

Self-study app for physics and maths textbooks. Photograph problems and handwritten solutions; an LLM reads and grades the working, and spaced repetition schedules reviews. Live demo available.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages