Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Edupets-Studio/Edu-pets/llms.txt

Use this file to discover all available pages before exploring further.

EduPets turns arithmetic practice into an adventure. Children adopt a virtual penguin whose food, sleep, and happiness stats slowly drain over time — the only way to restore them is by completing math exercises. Every correct answer helps the pet thrive, making learning feel like play.

Introduction

Understand what EduPets is, who it’s for, and how the learning loop works.

Quickstart

Run EduPets locally in minutes with Python and FastAPI.

Deploy to Vercel

Ship EduPets to production with a single Vercel deployment.

Virtual Pet

Learn how the pet’s stats, task system, and name customization work.

What’s inside

Math Exercises

Four focused exercise modes — addition, subtraction, multiplication, and division.

Exams

Mixed-operation exam mode that tests all four operations in one session.

Store

Cosmetic items children can unlock to personalize their experience.

Architecture

FastAPI, Jinja2 templates, and client-side localStorage — all explained.

How learning works

1

Adopt your pet

After logging in, a penguin named Pingüi is waiting on the pet dashboard. Its food, sleep, and happiness bars start at 100% and drain gradually while the app is open.
2

Accept a task

The task panel assigns a specific math operation (e.g., “complete a multiplication to earn food”). Finishing that exercise rewards the matching stat.
3

Play an exercise

Choose addition, subtraction, multiplication, or division from the game menu. Answer 10 multiple-choice questions before running out of three lives.
4

Take an exam

When ready, tackle the mixed exam — five questions drawn from all four operations with only two lives. Completing it returns a full stat boost.

Build docs developers (and LLMs) love