# Learning Hub

> AI-powered learning assistant that turns screen time into learning motivation. Tracks grades, checks homework, assigns bonus tasks, manages game minutes. Open-source, self-hosted.

# What is Learning Hub

Learning Hub is an AI tutor that lives in your child's messenger. It tracks grades, reviews homework, and turns screen time into motivation to study.

## How it works

The system is built on a simple principle: **screen time is a currency** that your child earns through studying.

- Excellent grade → +15 minutes
- Bad grade → −25 minutes
- Homework submitted on time → +10 minutes
- Homework overdue → −10 minutes

### For the child

Your child communicates with the AI tutor via Telegram. The tutor sends homework reminders, reviews assignments, and offers extra practice on weak topics.

> The tutor never gives ready-made answers — it uses the Socratic method and teaches independent thinking.

### For the parent

You set the rules once. Then the system runs on its own:

1. Grades are automatically pulled from the school system
2. Bad grades — alert sent to you or the tutor
3. Weekly report — minutes balance
4. Weak topics are tracked automatically

## Supported platforms

| Platform | Countries |
|----------|-----------|
| EduPage | Czech Republic, Slovakia, and others |
| PRONOTE | France |
| Manual entry | Any country |

## What's next

Head to [Game Minutes](/en/docs/game-minutes) to understand how the balance system works.


---

# Game Minutes: How the Balance Works

Game minutes are Learning Hub's currency. Your child earns them through studying and spends them on screen time. The balance works like a bank account: income increases it, expenses decrease it.

## Where minutes come from

Minutes are automatically awarded for every academic event:

### Grades

Each grade is immediately converted into minutes:

| Grade | Minutes | Meaning |
|-------|---------|---------|
| 1 (excellent) | +15 | Best result |
| 2 (good) | +10 | Good result |
| 3 (satisfactory) | 0 | No change |
| 4 (poor) | −20 | Penalty |
| 5 (fail) | −25 | Maximum penalty |

Whether the grade came automatically from the school system or was entered manually — minutes are awarded in both cases.

### Homework

- Submitted on time → **+10 minutes**
- Overdue → **−10 minutes**

More details in the [Homework](/en/docs/homework) section.

### Bonus tasks

Your child can earn extra minutes by completing bonus tasks on weak topics. The grade for the task is converted to minutes using the same table as regular grades.

More details in the [Bonus Tasks](/en/docs/bonus-tasks) section.

## Where minutes are spent

When your child plays, the parent tells the bot how many minutes were used. The bot deducts these minutes from the balance.

> The bot doesn't control screen time directly — it keeps track. The parent decides whether to allow playing with a negative balance.

## Manual adjustments

Sometimes you need to add or deduct minutes outside the standard rules. For example:

- Child helped with chores → parent adds a bonus
- Broke an agreement → parent applies a penalty

To do this, write to the bot, for example:
- "Add 20 minutes for helping with cleaning"
- "Deduct 30 minutes for breaking the agreement"

## Transaction types

Every balance change is a transaction of a specific type:

| Type | Description | Example |
|------|-------------|---------|
| Grade | Automatically on receiving a grade | A in math: +15 min |
| Homework | On submission or overdue | Submitted on time: +10 min |
| Bonus task | On completing an extra task | Physics task: +10 min |
| Manual adjustment | Bonus or penalty from parent | Helped with chores: +20 min |
| Gaming | Deduction for screen time | Played 30 minutes: −30 min |

## Weekly report

Every Saturday morning the bot sends the child a weekly report:

- What was earned (grades, homework, bonuses)
- What was spent (screen time, penalties)
- Current balance

The report is written in a friendly tone — praises successes, gently mentions setbacks.

## Not just games

Game minutes are an abstraction. You and your child can agree on any rules: minutes can convert to pocket money, a trip to the cinema, or any other reward at your discretion. The system keeps track — what the minutes stand for is up to you.

## Negative balance

The balance can go negative. This means the child has spent more minutes than earned. The system honestly shows the negative balance, but the decision about consequences is up to the parent.

## What's next

- [Grades](/en/docs/grades) — how grades enter the system
- [Bonus Tasks](/en/docs/bonus-tasks) — how to earn extra minutes
- [Configuration](/en/docs/configuration) — how to change the conversion table


---

# Grades: Tracking and Sync

Learning Hub tracks all your child's grades and automatically converts them into [game minutes](/en/docs/game-minutes). Grades can arrive in two ways: automatically from the school system or manually.

## Grading scale

Internally, Learning Hub uses a European 5-point scale:

| Grade | Meaning | Description |
|-------|---------|-------------|
| 1 | Excellent | Best result (A) |
| 2 | Good | Good result (B) |
| 3 | Satisfactory | Average result (C) |
| 4 | Poor | Weak result (D) |
| 5 | Fail | Failure (F) |

> If your country uses a different scale — don't worry. The system automatically converts grades. For example, a Ukrainian 8 out of 12 becomes 2 (good). More details in [Supported Countries](/en/docs/supported-countries).

## Automatic sync

If your school uses EduPage or PRONOTE — grades are loaded automatically. The bot periodically checks the school system and fetches new grades.

In the process:
- The grade is converted to the 5-point scale (if needed)
- Minutes are automatically added or deducted
- The original grade value is preserved (e.g., "2+" in the Czech system)

More about connecting — in the [School Sync](/en/docs/school-sync) section.

## Manual grade entry

If automatic sync is unavailable or you need to add a grade manually — any adult family member (parent, administrator, tutor) can ask the bot to record a grade.

Just write something like:
- "Give a 2 in math"
- "Got a 1 on the physics test"
- "Test grade — 3, subject: history"

The bot will ask for details if something is missing (subject, topic, date).

> The child cannot enter their own grades — this is only available to adults.

## Bad grade escalation

When a grade of 3, 4, or 5 appears — the bot automatically notifies the responsible adult:

- If a tutor is assigned to the subject — the message goes to the tutor
- If there's no tutor — to the family administrator

More details in the [Grade Escalation](/en/docs/grade-escalation) section.

## Connection to topic reviews

Any grade below excellent (2, 3, 4, 5) automatically creates a topic for review. The bot will offer the child [bonus tasks](/en/docs/bonus-tasks) on this topic until the knowledge is reinforced.

More details in the [Topic Reviews](/en/docs/topic-reviews) section.

## What's next

- [Game Minutes](/en/docs/game-minutes) — how grades affect the balance
- [School Sync](/en/docs/school-sync) — automatic grade import
- [Supported Countries](/en/docs/supported-countries) — conversion tables for 20 countries


---

# Connecting School Systems

Learning Hub can automatically pull grades and homework from your school's electronic system. This eliminates the need to enter everything manually.

## Supported systems

| System | Countries | What syncs |
|--------|-----------|------------|
| EduPage | Czech Republic, Slovakia, and others | Grades + homework |
| PRONOTE | France | Grades + homework |

> If your school doesn't use either of these systems — everything can be entered manually. The bot works with any country without auto-sync.

## How sync works

After connecting, the bot periodically (usually once a day) checks the school system:

1. **Fetches new grades** → converts to 5-point scale → awards [game minutes](/en/docs/game-minutes)
2. **Fetches homework** → creates entries with deadlines → the bot will [remind](/en/docs/homework) the child about them
3. **Notifies about bad grades** → if the grade is 3, 4, or 5, the bot will notify the [responsible adult](/en/docs/grade-escalation)

Original grade values are preserved. If a child in a Czech school got a "2+", you'll see both the original and the converted value.

## Connecting EduPage

To connect EduPage, you'll need:

- **Login** — email or username from the EduPage account
- **Password** — account password
- **School subdomain** — part of the school's address (e.g., `zsluhacovice` from `zsluhacovice.edupage.org`)

If you have a parent account with multiple children — the bot will ask which child to track.

> Credentials are stored locally on your server. They are not transmitted anywhere and never leave your system.

## Connecting PRONOTE

To connect PRONOTE, you'll need:

- **URL** — full address of your PRONOTE page (e.g., `https://xxx.index-education.net/pronote/eleve.html`)
- **Login** — username
- **Password** — account password

## Setup

Connection happens through a dialog with the bot during initial system setup. The bot:

1. Asks which school system you use
2. Requests the necessary credentials
3. Tests the connection
4. On success — begins syncing

If your child attends multiple schools — you can connect [multiple schools simultaneously](/en/docs/multiple-schools).

## Without auto-sync

If your school isn't supported — that's not a problem. All Learning Hub features are available with manual entry:

- Parent or tutor enters grades through the bot
- Homework is created manually
- Minutes system, bonus tasks, reports — everything works the same

More about manual entry in the [Grades](/en/docs/grades) and [Homework](/en/docs/homework) sections.

## What's next

- [Supported Countries](/en/docs/supported-countries) — full list of countries and grading scales
- [Multiple Schools](/en/docs/multiple-schools) — if the child attends two schools
- [Automated Schedules](/en/docs/automated-schedules) — how to set up sync frequency


---

# Homework

Learning Hub tracks homework assignments, sends deadline reminders, reviews submissions, and awards [game minutes](/en/docs/game-minutes) for on-time completion.

## Where assignments come from

Homework enters the system in two ways:

- **Automatically** — from the school system (EduPage, PRONOTE) during [sync](/en/docs/school-sync)
- **Manually** — a parent, administrator, or tutor creates an assignment through the bot

To create one manually, just write to the bot:
- "Assign math homework: problems 1-5, page 42, due Friday"
- "English homework — learn words from lesson 3"

The bot will ask for missing details (subject, deadline, description).

## Deadlines and reminders

Every assignment has a deadline. If only a date is given without a time — the deadline is set to 8:00 PM local time.

The bot reminds the child about approaching deadlines:

- **2 days before** — gentle reminder
- **1 day before** — more insistent reminder

Reminders are sent on weekdays at 5:00 PM. Each reminder is sent only once — the bot won't spam.

## Submitting homework

The child submits homework by writing to the bot in direct messages. They can send:

- A text answer
- A photo of their notebook
- A file with the solution

The bot will determine which assignment the submission relates to and begin reviewing.

## How the bot reviews work

The bot evaluates work using the Socratic method — it doesn't just give a grade, but helps understand the material:

- Points out what was done correctly
- Explains mistakes and suggests corrections
- Asks guiding questions if the answer is incomplete
- Adapts explanation complexity to the child's age

> The bot never gives ready-made answers. It teaches independent thinking.

### Recommended grade

The bot assigns a recommended grade on the 5-point scale:

- **1, 2, 3** — the work is accepted, the assignment is closed
- **4, 5** — the bot suggests the child redo the work

This is just a recommendation — the final grade is given by the teacher at school.

### If the child refuses to redo

If the grade is 4 or 5 and the child says "I won't redo it" — the bot doesn't insist and redirects the issue to the responsible adult (subject tutor or administrator).

## Impact on minutes balance

- Assignment submitted **before the deadline** → **+10 minutes**
- Assignment **overdue** → **−10 minutes**

Minutes are awarded automatically when the assignment status changes.

## Textbook integration

If the assignment is linked to a textbook from the [library](/en/docs/textbooks) — the bot can find the relevant page and send it to the child. This also helps during review: the bot understands the assignment context better when it can see the source material.

## What's next

- [Game Minutes](/en/docs/game-minutes) — how homework affects the balance
- [Textbook Library](/en/docs/textbooks) — materials for completing assignments
- [Automated Schedules](/en/docs/automated-schedules) — reminder settings


---

# Bonus Tasks

Bonus tasks are a way to earn extra [game minutes](/en/docs/game-minutes) by reviewing weak topics. The bot selects a topic, formulates a task, and evaluates the result.

## How it works

1. The child asks for a bonus task ("I want to earn minutes", "give me a task")
2. The bot checks if tasks are available (there are limits — more on that below)
3. The bot selects a topic for review — priority goes to topics with bad grades
4. The bot formulates a task and sends it to the child
5. The child completes it and sends the answer
6. The bot evaluates the work and awards minutes

## Topic selection

The bot doesn't give random tasks — it selects a topic the child needs to improve.

**Priority:** worst grade → fewer repetitions → more recent topic.

If all weak topics have been worked through — the bot doesn't stop. It randomly selects a topic from recent grades (last 30 days). If you've configured [favorite subjects](/en/docs/configuration) — the bot will prefer a topic from those first. The task will be non-standard and exploratory — a creative problem, quiz, or real-world application. This is voluntary practice, and the bot praises the child for taking initiative.

## Difficulty levels

The bot selects task difficulty automatically, considering the child's age, grade on the topic, and number of repetitions:

| Level | Time | What it tests |
|-------|------|---------------|
| Basic | 5–10 min | Understanding fundamentals: explain in your own words, give an example |
| Intermediate | 10–15 min | Applying knowledge: solve a problem in a new context, find an error |
| Advanced | 15–20 min | Deep understanding: tricky problems, analysis, argumentation |

> The child doesn't see the difficulty level — for them it's just a task.

For younger children, tasks are simpler and shorter. For teenagers — more analytical. The bot adapts to age.

## Grading and awarding minutes

After submission, the bot evaluates the work. If the answer is weak (grade 4 or 5) — the task doesn't close. The bot explains the mistakes and suggests trying again. The task is only accepted with a grade of 1, 2, or 3:

| Grade | Minutes |
|-------|---------|
| 1 (excellent) | +15 |
| 2 (good) | +10 |
| 3 (satisfactory) | 0 |

Unlike homework, here the bot grades directly — it's the bot's own task and it evaluates it.

## Limits

To prevent the system from becoming a "minutes factory", there are restrictions:

- **Maximum 4 incomplete tasks** at once — can't stockpile tasks without doing them
- **Maximum 15 tasks per week** — calculated on a rolling 7-day window

If the limit is reached, the bot will politely say that new tasks are currently unavailable. The specific limit numbers are not revealed to the child.

Tasks that remain incomplete for more than 7 days are automatically cancelled.

## Daily suggestion

Every day at 4:00 PM, the bot checks if there are topics for review. If so — it sends the child a friendly suggestion to earn some minutes. The task itself is not created — just the suggestion. If the child agrees, they'll write to the bot, and then the full process begins.

## Connection to topic reviews

Bonus tasks are the main mechanism for reinforcing weak topics. Any grade below excellent creates a topic for review. The number of required repetitions depends on the grade:

| Grade | How many times to repeat |
|-------|--------------------------|
| 2 | 1 time |
| 3 | 2 times |
| 4 | 3 times |
| 5 | 3 times |

After enough repetitions, the topic is considered reinforced and is closed.

More details in the [Topic Reviews](/en/docs/topic-reviews) section.

## What's next

- [Topic Reviews](/en/docs/topic-reviews) — how the system tracks progress
- [Game Minutes](/en/docs/game-minutes) — how the minutes balance works overall
- [Configuration](/en/docs/configuration) — how to change limits and thresholds


---

# Textbook Library

Learning Hub stores your child's textbooks in digital form. The bot can find the right page, send topic-related material, and use the textbook when reviewing [homework](/en/docs/homework).

## Why this matters

- Your child can ask "show me page 42 in math" — and the bot will send the relevant excerpt
- When reviewing homework, the bot sees the original assignment from the textbook — grading is more accurate
- Bonus tasks are formulated using real study materials

## How to add a textbook

Textbooks are added in PDF format. The process:

1. Place the PDF file in a special folder on the server
2. Write to the bot: "Add textbooks" or "There are new books in the folder"
3. The bot will process each file:
   - Determine the subject (or ask you)
   - Create a description and table of contents
   - Split into convenient fragments for quick searching
   - Register in the library

> Don't send textbooks through the messenger — file names get lost during forwarding. Place files directly on the server.

## How the child gets material

The child can ask the bot:

- "Give me the math textbook"
- "I need the page with problem 2"
- "Show me lesson 5 on science"
- "I need the textbook for homework"

The bot will find the right textbook and send:
- **Text excerpt** — in message format (convenient to read on a phone)
- **PDF extract** — relevant pages from the original (with pictures and diagrams)

If the requested textbook isn't found — the bot will honestly say so and suggest which subjects are already in the library.

## What's stored in the library

For each textbook, the system stores:

- **Original PDF** — full version of the book
- **Description** — brief information about the content
- **Table of contents** — index of sections and topics
- **Fragments** — the textbook split into 10-15 page sections for quick searching

## Connection to homework

When homework is linked to a textbook — the bot automatically finds the relevant page during review. This helps:

- Understand what exactly was required in the assignment
- Grade the completeness of the answer more accurately
- Provide more specific feedback

## What's next

- [Homework](/en/docs/homework) — how the bot reviews assignments
- [Bonus Tasks](/en/docs/bonus-tasks) — extra practice on weak topics


---

# Weak Topic Reviews

When a child gets a bad grade, Learning Hub doesn't just record it — it remembers the topic and helps reinforce it through [bonus tasks](/en/docs/bonus-tasks).

## How it works

1. The child receives a grade of 2, 3, 4, or 5 on a specific topic
2. The system creates a "topic for review" — a record that this topic needs reinforcement
3. When the child takes a bonus task — the bot prioritizes weak topics
4. After enough repetitions, the topic is considered reinforced

## How many repetitions are needed

The number of repetitions depends on the grade — the worse the grade, the more repetitions:

| Grade | Repetitions to close |
|-------|---------------------|
| 2 (good) | 1 |
| 3 (satisfactory) | 2 |
| 4 (poor) | 3 |
| 5 (fail) | 3 |

Each successfully completed bonus task on the topic counts as one repetition.

## Topic priority

When the child asks for a bonus task, the bot doesn't choose a topic randomly. Priority:

1. **Worst grade** — topics with 5s and 4s come first
2. **Fewer repetitions** — topics that haven't been reviewed yet are more important
3. **More recent** — recent topics are more relevant

To prevent the child from getting stuck on one topic, the bot randomly selects from the 4 highest-priority topics.

## When all topics are closed

If all weak topics have been worked through and the child wants another task — the bot doesn't refuse. Instead, it randomly selects a topic from recent grades (last 30 days). If [favorite subjects](/en/docs/configuration) are configured — the bot will prefer a topic from those. The task will be non-standard and exploratory — to dive deeper into the subject. This is voluntary practice, and the bot always praises the initiative.

## Non-academic subjects

After grade sync, the system may create review topics for PE, music, art, or shop class. The bot automatically closes such topics — bonus tasks for them don't make sense.

## What's next

- [Bonus Tasks](/en/docs/bonus-tasks) — how the child completes reviews
- [Grades](/en/docs/grades) — how grades enter the system
- [Configuration](/en/docs/configuration) — how to change repetition thresholds


---

# Grade Escalation

When a child receives a bad grade (3, 4, or 5), Learning Hub automatically notifies the responsible adult. You'll learn about the problem right away — without waiting for a parent-teacher conference.

## How it works

After each automatic [grade sync](/en/docs/school-sync), the bot checks if new bad grades appeared. If so:

1. **Determines the recipient** — who should receive the notification
2. **Groups grades** — one message per person, even if there are multiple grades
3. **Sends the notification** — brief, to the point, no drama

## Who receives the notification

The bot determines the recipient by subject:

- If the subject has an assigned **tutor** → the notification goes to the tutor
- If there's no tutor → the notification goes to the family **administrator**

This means grandma, who helps with math, will only get alerts about math. The administrator gets everything else.

## What the notification contains

The message includes:
- Subject
- Grade (in the original scale, if available)
- Date
- Topic (if available from the school system)

The tone is calm and factual. No judgmental statements or dramatization.

## Only after auto-sync

Escalation only triggers for grades received through automatic sync (EduPage, PRONOTE). If an adult enters a grade manually — no notification is sent, because the person already knows.

## Repeated notifications

Each grade is escalated only once. If delivery failed (e.g., the messenger was unavailable) — the grade stays in the queue and will be sent during the next check.

## What's next

- [Grades](/en/docs/grades) — how grades enter the system
- [Family and Roles](/en/docs/family-members) — how to assign a tutor to a subject
- [School Sync](/en/docs/school-sync) — setting up auto-sync


---

# Family and Roles

In Learning Hub, every family member has a role that determines their permissions and capabilities in the system.

## Roles

| Role | Description | Permissions |
|------|-------------|-------------|
| Administrator | Parent who manages everything | Full access: settings, grades, minutes, tasks |
| Parent | Parent without admin rights | View data, manual grade and homework entry |
| Student | The child | View own grades, balance, tasks. Complete homework and bonuses |
| Tutor | Teacher for specific subjects | Receives alerts for their subjects, can enter grades |
| Relative | Other family members | Limited viewing |

### Minimum for the system to work

For Learning Hub to function, you need at least two participants:
- **One administrator** — manages settings
- **One student** — the one whose studies are being tracked

## Communication channels

Each family member can be linked to a messenger — this is how the bot knows who to send messages to and who they're coming from.

Supported messengers:
- Telegram
- WhatsApp
- Discord
- Slack
- Signal
- iMessage
- Microsoft Teams
- Matrix

> Currently, Telegram has the most complete support. Other messengers are available through OpenClaw.

When someone writes to the bot, the system automatically identifies who it is — by the linked channel. This is important for access control: a child cannot perform actions that are only available to adults.

## Tutors

Tutor is a special role. They can be assigned as responsible for specific subjects. After that:

- Bad grades in those subjects will go to the tutor, not the administrator
- If the child refuses to redo homework — the bot will redirect the issue to the tutor

This is convenient when different people are responsible for different subjects. For example, grandma helps with math, and an aunt helps with English.

## Setup

On first launch, the bot will guide you through family setup:

1. Creating an administrator and linking a messenger
2. Adding a student (name, date of birth, messenger)
3. Optionally — adding other family members

Everything is done through a chat with the bot — no forms or interfaces.

## What's next

- [Grade Escalation](/en/docs/grade-escalation) — how adult notifications work
- [Configuration](/en/docs/configuration) — general system settings


---

# Content Safety

Learning Hub takes seriously what content your child receives. The bot filters external resources, adapts materials to the child's age, and teaches critical thinking.

## What gets filtered

When the child asks the bot to find something outside the [textbook library](/en/docs/textbooks) — a link, video, or topic explanation — the bot checks the content against several criteria.

### Absolutely prohibited content

The bot will never provide materials containing:
- Sexual content involving minors
- Self-harm instructions
- Drug, alcohol, and tobacco promotion for children
- Weapons manufacturing instructions
- Terrorism and extremism propaganda
- Bullying and gambling-related content

### Prohibited link types

- Social media (TikTok, Instagram, Twitter/X)
- Forums and chats (risk of contact with strangers)
- Sites with aggressive advertising
- Shortened links (bit.ly and similar)
- Sites requiring registration

### Allowed resources

- Educational platforms (Khan Academy, Wikipedia, Britannica)
- Government educational resources (.gov, .edu)
- Library digital resources

> Short videos (Shorts, under 60 seconds) are not used as educational resources. Research links heavy consumption of short videos with decreased attention span.

## Age adaptation

The bot considers the child's age when selecting materials:

| Age | Format | Features |
|-----|--------|----------|
| 6–8 years | Short segments (5-15 min), visual | Simple language, concrete examples, no frightening content |
| 9–11 years | Segments up to 20-30 min | Expanded vocabulary, logical reasoning |
| 12–14 years | Long content (30-45 min), documentaries | Social topics, historical conflicts with educational context |
| 15–18 years | No format restrictions | Academic papers, debates, philosophy |

## Protection from low-quality content

The bot recognizes low-quality content by signs:
- Rapid cuts (1-3 seconds between frames)
- No educational purpose
- Emotional manipulation (shock, fear, anger)
- Aggressive humor and violence as comedy

If the child sends such content — the bot will explain why it's not suitable for studying and suggest a quality alternative.

## Protection from misinformation

The bot checks content for signs of conspiracy theories and misinformation:
- Sensational headlines ("THEY don't want you to know this!")
- Claims from a single source only
- Appeal to hidden knowledge
- Arguments built on emotions, not facts

Instead of simply blocking, the bot uses such moments as opportunities to teach critical thinking (for children aged 10 and above).

## Teaching critical thinking

The bot doesn't just filter — it teaches the child to independently evaluate information. For children aged 10 and above, the SIFT method is used:

- **S — Stop**: don't trust immediately, notice your emotional reaction
- **I — Investigate**: who made this? What's their expertise and motivation?
- **F — Find**: look for the same claim in several independent sources
- **T — Trace**: find the original source (research, data)

## Textbook library content

Materials from the Learning Hub [textbook library](/en/docs/textbooks) are pre-verified internal content. No additional filtering is required for them.

## What's next

- [Textbook Library](/en/docs/textbooks) — safe educational materials
- [Family and Roles](/en/docs/family-members) — access control in the system


---

# Supported Countries

Learning Hub works with 20 countries. Each one has a configured grading scale and conversion rules to the unified 5-point system.

## How conversion works

Internally, Learning Hub stores all grades on a unified scale from 1 (best) to 5 (worst). If your country uses a different scale — grades are automatically converted. The original value is always preserved.

> You don't need to understand the conversion — the system does everything automatically. The table below is for reference.

## Country and scale table

### Europe

| Country | School scale | Conversion to Learning Hub |
|---------|-------------|---------------------------|
| Czech Republic (CZ) | 1–5 (1 is best) | Matches, no conversion needed |
| Slovakia (SK) | 1–5 (1 is best) | Matches, no conversion needed |
| Austria (AT) | 1–5 (1 is best) | Matches, no conversion needed |
| Germany (DE) | 1–6 (1 is best) | 1→1, 2→2, 3→3, 4→4, 5-6→5 |
| France (FR) | 0–20 (20 is best) | 16-20→1, 14-15→2, 12-13→3, 8-11→4, 0-7→5 |
| United Kingdom (GB) | GCSE 9–1 (9 is best) | 8-9→1, 6-7→2, 4-5→3, 2-3→4, 1→5 |
| Spain (ES) | 0–10 (10 is best) | 9-10→1, 7-8→2, 5-6→3, 3-4→4, 0-2→5 |
| Italy (IT) | 1–10 (10 is best) | 9-10→1, 7-8→2, 6→3, 4-5→4, 1-3→5 |
| Poland (PL) | 1–6 (6 is best) | 6→1, 5→2, 4→3, 3→4, 1-2→5 |
| Netherlands (NL) | 1–10 (10 is best) | 9-10→1, 8→2, 6-7→3, 5→4, 1-4→5 |
| Switzerland (CH) | 1–6 (6 is best) | 6→1, 5→2, 4→3, 3→4, 1-2→5 |
| Ukraine (UA) | 1–12 (12 is best) | 10-12→1, 7-9→2, 4-6→3, 2-3→4, 1→5 |

### Americas

| Country | School scale | Conversion to Learning Hub |
|---------|-------------|---------------------------|
| USA (US) | A–F (A is best) | A→1, B→2, C→3, D→4, F→5 |
| Canada (CA) | A–F (A is best) | A→1, B→2, C→3, D→4, F→5 |
| Argentina (AR) | 1–10 (10 is best) | 9-10→1, 7-8→2, 5-6→3, 3-4→4, 1-2→5 |
| Brazil (BR) | 0–10 (10 is best) | 9-10→1, 7-8→2, 5-6→3, 3-4→4, 0-2→5 |

### Asia and Oceania

| Country | School scale | Conversion to Learning Hub |
|---------|-------------|---------------------------|
| India (IN) | CBSE A1–E | A1→1, A2-B1→2, B2-C1→3, C2-D→4, E→5 |
| Bangladesh (BD) | GPA 0–5 (5 is best) | GPA 5→1, 4-3.5→2, 3→3, 2-1→4, 0→5 |
| Japan (JP) | 1–5 (5 is best) | 5→1, 4→2, 3→3, 2→4, 1→5 |
| Australia (AU) | A–E (A is best) | A→1, B→2, C→3, D→4, E→5 |

## Automatic sync

Out of 20 countries, automatic grade sync is available for:

| System | Countries |
|--------|-----------|
| EduPage | Czech Republic, Slovakia, and other countries where schools use EduPage |
| PRONOTE | France |

For all other countries — [manual grade entry](/en/docs/grades). All system features are still available.

## Your country not on the list?

Learning Hub supports manual grade entry for any country in the world. If grades are entered manually — you can enter them directly on the 5-point scale or ask the bot to convert.

## What's next

- [Grades](/en/docs/grades) — how grades enter the system
- [School Sync](/en/docs/school-sync) — setting up auto-sync
- [Multiple Schools](/en/docs/multiple-schools) — if the child studies in two countries


---

# Configuration

Learning Hub comes with sensible defaults. But you can change any parameter to fit your family — just write to the bot in chat.

> All settings are changed through a dialog with the bot. You are the administrator, and the bot will fulfill your request.

## Main parameters

### Grade-to-minutes conversion table

Determines how many [game minutes](/en/docs/game-minutes) are awarded for each grade.

| Grade | Default |
|-------|---------|
| 1 (excellent) | +15 min |
| 2 (good) | +10 min |
| 3 (satisfactory) | 0 min |
| 4 (poor) | −20 min |
| 5 (fail) | −25 min |

To change, write to the bot, for example:
- "Set 20 minutes for an excellent grade instead of 15"
- "Increase the penalty for a failing grade to −30 minutes"

### Homework bonuses

| Parameter | Default |
|-----------|---------|
| Bonus for on-time submission | +10 min |
| Penalty for being overdue | −10 min |

To change, write to the bot:
- "Set the bonus for on-time homework to 15 minutes"
- "Remove the penalty for overdue homework" (will set to 0)

### Default deadline time

If [homework](/en/docs/homework) is assigned with a date but no time — the deadline is set to **8:00 PM** local time.

To change, write to the bot:
- "Change the default deadline time to 7:00 PM"

## Bonus task parameters

| Parameter | Default | Description |
|-----------|---------|-------------|
| Max incomplete tasks | 4 | How many [bonus tasks](/en/docs/bonus-tasks) can be active simultaneously |
| Max tasks per week | 15 | How many tasks can be completed in 7 days |

To change, write to the bot:
- "Increase the incomplete bonus task limit to 6"
- "Limit bonus tasks to 10 per week"

## Favorite subjects

You can mark up to 3 subjects as "favorites". This affects [bonus tasks](/en/docs/bonus-tasks): when all weak topics have been worked through and the child asks for another task, the bot will first suggest a topic from favorite subjects.

If favorite subjects aren't configured — the bot may suggest setting them up.

To configure, write to the bot:
- "Mark math and English as favorite subjects"
- "Remove physics from favorite subjects"

## Topic repetition thresholds

Determine how many times a [topic needs to be reviewed](/en/docs/topic-reviews) through bonus tasks before it's considered reinforced.

| Grade | Default |
|-------|---------|
| 2 (good) | 1 repetition |
| 3 (satisfactory) | 2 repetitions |
| 4 (poor) | 3 repetitions |
| 5 (fail) | 3 repetitions |

To change, write to the bot:
- "Set 3 repetitions for satisfactory grades instead of 2"
- "Reduce repetitions for poor grades to 2"

## Communication language

Learning Hub communicates with the family in your chosen language. This parameter is set during initial setup and affects:

- Bot message language to the child
- Parent notification language
- Weekly report language

To change, write to the bot:
- "Switch the communication language to English"

## Initial setup

On first launch, the bot automatically checks system readiness and guides you through setup:

1. Communication language
2. Family members and their messengers
3. School and sync connection (if available)
4. Verification of all required parameters

After setup is complete, the bot creates [automated schedules](/en/docs/automated-schedules) and the system starts working.

## What's next

- [Game Minutes](/en/docs/game-minutes) — how the balance system works
- [Bonus Tasks](/en/docs/bonus-tasks) — limits and parameters
- [Topic Reviews](/en/docs/topic-reviews) — repetition thresholds


---

# Multiple Schools

If your child attends two schools or studies in two countries — Learning Hub can handle it. The system supports multiple schools simultaneously, each with its own grading scale.

## When you need this

- The child attends a local school and studies online at a school in another country
- The family moved, and the child is finishing at the old school while starting a new one
- Different subjects are taught through different educational systems

## How it works

Each school in Learning Hub is a separate entry with:

- Country code
- Name
- Grading scale and conversion rules

Subjects are linked to a specific school. This means "Math" at the Czech school and "Math" at the Ukrainian school are two different subjects with different grades.

### Grade conversion

Each school has its own conversion table to the unified 5-point scale. For example:

- Czech three (3 out of 5) → 3 in Learning Hub
- Ukrainian three (3 out of 12) → 5 in Learning Hub (that's a fail!)

Full conversion tables are in the [Supported Countries](/en/docs/supported-countries) section.

### One minutes balance

Despite multiple schools, the [game minutes balance](/en/docs/game-minutes) is shared. Grades from all schools are converted to minutes and added to a single account.

## Sync

Each school can have its own sync provider configured. For example:

- Czech school → EduPage (automatic)
- Ukrainian school → manual entry

The bot will sync each school on its own schedule.

## Setup

Schools are activated during system setup. The bot will ask:

1. In which countries the child studies
2. Which school systems are used
3. Whether auto-sync is needed

You can add a new school at any time — just write to the bot.

## What's next

- [Supported Countries](/en/docs/supported-countries) — grading scales for 20 countries
- [School Sync](/en/docs/school-sync) — setting up auto-sync
- [Grades](/en/docs/grades) — how grades from different schools enter the system


---

# Automated Schedules

Learning Hub performs a number of tasks automatically on a schedule. You don't need to remember about reminders or reports — the bot handles everything on its own.

## Standard tasks

During system setup, the bot creates 5 automated tasks:

### Homework reminders

- **When:** Monday — Friday, 5:00 PM
- **To:** the child
- **What it does:** checks if there are homework assignments with approaching deadlines. If so — sends a reminder. 2 days before — gentle, 1 day before — more insistent.

### Game time logging reminder

- **When:** Wednesday, 12:00 PM
- **To:** the administrator
- **What it does:** checks if anyone has logged game time in the past week. If not — reminds the administrator to enter the data.

### Weekly balance report

- **When:** Saturday, 9:00 AM
- **To:** the child
- **What it does:** sends a weekly summary — what was earned, what was spent, current [minutes balance](/en/docs/game-minutes). Written in a friendly tone, adapted to the child's age.

### Bonus task suggestion

- **When:** daily, 4:00 PM
- **To:** the child
- **What it does:** checks if there are topics for [review](/en/docs/topic-reviews). If so — suggests the child earn minutes through a [bonus task](/en/docs/bonus-tasks). The task itself is not created — just the suggestion.

### Closing overdue homework

- **When:** daily, 1:00 AM
- **To:** nobody (background task)
- **What it does:** automatically marks overdue homework assignments. Penalty minutes are applied in the process.

## School grade sync

If a [school system](/en/docs/school-sync) is connected (EduPage, PRONOTE), the bot sets up an additional schedule for periodic grade and homework sync. This usually happens once a day.

## Schedule configuration

All schedules are configured during the initial system setup. The bot will show the proposed times and ask for confirmation. You can:

- Change the time of any task
- Times are shown in your local timezone

## What's next

- [Homework](/en/docs/homework) — how deadline reminders work
- [Game Minutes](/en/docs/game-minutes) — weekly balance report
- [Bonus Tasks](/en/docs/bonus-tasks) — daily suggestions


---

# Frequently Asked Questions

## General

### What is Learning Hub?

It's an AI tutor that lives in your child's messenger. It tracks grades, reviews homework, offers tasks on weak topics, and manages screen time. More details in [What is Learning Hub](/en/docs).

### Is Learning Hub free?

Yes. The project is free and open source. You need your own server for installation.

### Do I need technical skills to install it?

Installation is done by an AI bot — you send it an instruction, and it sets up everything on your server. A basic understanding of what a server is and how to connect to it is helpful, but deep technical knowledge is not required.

### How many children does the system support?

One Learning Hub installation is designed for one child. This is intentional: the AI tutor is fully focused on one student — their grades, weak topics, communication style, and age. If you have multiple children — deploy a separate instance for each.

### Which messengers does the bot work with?

The primary messenger is Telegram. WhatsApp, Discord, Slack, Signal, and others are also supported through the OpenClaw platform.

## Grades and minutes

### How do grades turn into game minutes?

Each grade is automatically converted using the [table](/en/docs/game-minutes): excellent = +15 min, good = +10 min, satisfactory = 0, poor = −20 min, fail = −25 min. The table can be [customized](/en/docs/configuration).

### What happens if the balance goes negative?

The system will honestly show the negative balance. The decision about consequences is yours — the bot doesn't block games directly.

### Can minutes be added manually?

Yes. Any adult family member can award bonus minutes (e.g., for helping with chores) or apply a penalty with a stated reason.

### We have a different grading scale. Is that a problem?

No. Learning Hub supports [20 countries](/en/docs/supported-countries) with automatic conversion. If your country isn't on the list — grades can be entered manually.

## Homework

### Does the bot give ready-made answers?

No. The bot uses the Socratic method — it asks guiding questions, points out mistakes, explains concepts. It teaches thinking, not copying.

### Who gives the final grade for homework?

The bot gives a recommended grade. The final grade is up to the teacher at school. More details in the [Homework](/en/docs/homework) section.

### What if the child submits poor work and refuses to redo it?

The bot doesn't insist. It redirects the issue to the responsible adult — the [tutor](/en/docs/family-members) for the subject or the administrator.

## Bonus tasks

### How often can the child take bonus tasks?

By default — up to 4 incomplete at once and up to 15 per week. These [limits can be customized](/en/docs/configuration).

### What topics are tasks given on?

The bot selects topics where there were bad grades. Priority goes to the weakest topics. If all weak topics have been worked through — the bot randomly suggests a topic from recent grades, with priority for [favorite subjects](/en/docs/configuration).

### How many minutes can be earned from a bonus task?

The same as for a regular grade: excellent = +15 min, good = +10 min. More details in the [Bonus Tasks](/en/docs/bonus-tasks) section.

## Security

### Can the child change their grades or balance?

No. The bot identifies who is writing by the linked messenger. The child cannot perform actions available only to adults.

### What content does the bot show the child?

The bot filters external content by [strict rules](/en/docs/content-safety): checks safety, age appropriateness, and educational value. Textbooks from the library are pre-verified content.

### Where is data stored?

All data is stored on your server. Nothing goes to third-party servers. School system credentials are stored locally and are not transmitted externally.

## Configuration

### Can parameters be changed after installation?

Yes. All parameters can be changed at any time through a dialog with the bot. More details in the [Configuration](/en/docs/configuration) section.

### Can multiple schools be connected?

Yes. Learning Hub supports [multiple schools simultaneously](/en/docs/multiple-schools), each with its own grading scale and sync.

### How do I assign a tutor to a subject?

Add the tutor as a [family member](/en/docs/family-members) with the "tutor" role, then link them to specific subjects. The bot will help with the setup.


---