Readtheory.py

An automated HTTP-based ReadTheory bot.

Readtheory is a free online reading platform offering personalized reading comprehension exercises for students of all ages. It is also used in schools to teach English reading, sometimes even given up as homework. In readtheory you get KP (Knowledge Points) for answering questions correctly.

Answer speed ≈
750 quizzes / hour
20 quizzes / minute

KP speed (in my testing) ≈
38000 KP / hour
640 KP / minute

--- INSTALLATION ---

This bot only works on devices with [Python](https://www.python.org/).
It has been tested on linux (ubuntu), but should also work on windows.

Install dependancies

pip install requests

Clone the repo

git clone https://github.com/bot910/readtheory.py

Run the code

cd readtheory.py
python main.py

--- SETUP ---

1. Get your user ID from the browser developer tools:
   • Open your developer tools and go to the Network tab (on the top).
   • Reload the website and search for a POST request where the name is a 8-10 numbe long string.
   • This is your user ID. (if you get an http error you probably inputed the wrong userID)

2. Get your AUTH bearer token from the browser developer tools:
   • Click on the POST request.
   • Go to the Headers tab.
   • Look under Request Headers for an Authorization header (the value should "Bearer ....").
   • This is your AUTH bearer token

The different operating modes:

1. normal mode - fetches quiz data and answers all questions correctly.
2. custom mode - choose what percentage of questions to answer correctly (on average).
3. grade mode - choose what grade level to get to.
   4. advanced grade mode - choose between what grades to switch between in order (e.g. 6,10,11).

Visit ReadTheory to see for yourself, and to check your KP

If the program doesn't work the first time; google it or open a github issue.

Made and developed by Bot910

© 2025 Bot910