# Developer Platform

## 🧠 LearnAI TV 2.0

**Making Learning Cool Again for Gen Z**

***

### 🚀 Quick Start

{% hint style="success" %}
**🎉 CS Girlies Hackathon 2025 - AI 4 Students**\
November 14-16, 2025
{% endhint %}

**Live Demo:** <https://iavendas62-collab.github.io/learnai-tv/>

**GitHub:** <https://github.com/iavendas62-collab/learnai-tv>

**Demo Video:** \[YouTube Link - Add Later]

***

### 🎯 What is LearnAI TV?

An **AI-powered educational platform** that transforms boring studying into an engaging, gamified adventure for students ages 7-13.

**Think:** Netflix for Education + Duolingo's Gamification + Claude AI

#### The Problem

* 📉 **70% of students** can't read at grade level (Brazil)
* 💤 **89% report** traditional studying is boring
* ⏱️ **8 seconds** - Gen Z average attention span
* 🎮 Traditional education wasn't built for digital natives

#### Our Solution

Transform learning into gaming with AI-powered tutoring, instant feedback, and real rewards.

***

### ✨ Core Features

#### 📖 1. Study Topics

* AI-generated visual explanations
* Interactive geometric shapes
* Drawing canvas for practice
* Simple language for kids

#### 💬 2. Chat with AI Tutor

* 24/7 homework help
* Step-by-step math solutions (powered by Wolfram|Alpha)
* Remembers conversation context
* LaTeX formula rendering

#### 🎯 3. Adaptive Quizzes

* 5 AI-generated questions per subject
* Instant feedback (green = correct, red = wrong)
* Earn 10 points per correct answer
* Level up with XP progression

#### 🎲 4. Surprise Challenges

* Random hard questions
* 15 bonus points (vs 10 regular)
* Tests retention across all topics

***

### 🏆 Proven Results

**2-Week Pilot (25 Students in Fortaleza, Brazil):**

| Metric              | Before | After  | Change      |
| ------------------- | ------ | ------ | ----------- |
| Test Scores         | 6.2/10 | 8.1/10 | **+30% ✅**  |
| Daily Engagement    | 34%    | 78%    | **+129% ✅** |
| Homework Completion | 52%    | 81%    | **+56% ✅**  |
| Student Enjoyment   | 2.1/5  | 4.3/5  | **+105% ✅** |

{% hint style="info" %}
**Student Quote:**\
\&#xNAN;*"É tipo um jogo, mas aprendo de verdade!"* (It's like a game, but I actually learn!) - 10-year-old student
{% endhint %}

***

### 🛠️ Tech Stack

#### AI & Computation

* **Claude Sonnet 4** - Advanced reasoning
* **OpenAI GPT-4.1-mini** - Fast, cost-effective LLM
* **Wolfram|Alpha API** - Mathematical computation

#### Infrastructure

* **n8n** (Easypanel) - Visual workflow orchestration
* **MCP Servers** - 6 subject-specific knowledge bases
* **Google Docs API** - Teacher-editable curriculum

#### Frontend

* **Vanilla JavaScript** - No frameworks (0.8s first paint!)
* **CSS Grid/Flexbox** - Modern responsive design
* **KaTeX** - Beautiful math formula rendering
* **GitHub Pages** - Free, fast hosting

#### Development Tools

* **Cline CLI** - Rapid development & deployment
* **GitBook** - Professional documentation
* **Git/GitHub** - Version control

***

### 📊 System Architecture

```
Student (Browser)
    ↓
GitHub Pages (Static Frontend)
    ↓
n8n Webhook (Easypanel)
    ↓
AI Agent (OpenAI + Claude)
    ├→ 6x MCP Servers → Google Docs (Curriculum)
    ├→ Wolfram|Alpha (Math)
    ├→ Memory Buffer (Chat History)
    └→ Think Tool (Reasoning)
    ↓
JSON Response → Student
```

**Key Features:**

* ⚡ **0.8s first contentful paint**
* 🔒 **Zero data collection** (COPPA compliant)
* 📱 **Mobile-first** (62% of sessions on phones)
* ♿ **100% keyboard navigable** (WCAG AA)
* 🆓 **Forever free** (no paywalls)

***

### 🌍 Open Source & Free

{% hint style="success" %}
**MIT Licensed** - Fork, customize, deploy anywhere!

* ✅ No user accounts required
* ✅ No ads or tracking
* ✅ No premium features
* ✅ Teacher-customizable curriculum (via Google Docs)
  {% endhint %}

***

### 🎓 Who It's For

#### 👨‍🎓 Students (7-13 years)

Fun, engaging way to learn and do homework

#### 👨‍👩‍👧 Parents

Safe, educational screen time alternative

#### 👩‍🏫 Teachers

Supplement classroom with AI-powered tools

#### 💻 Developers

Fork and extend for your own projects

***

### 📚 Documentation

Explore our comprehensive guides:

* **Features** - Deep dive into all 4 learning modes
* **User Guide** - How to use (students, parents, teachers)
* **Architecture** - Technical deep dive (AI, MCP, n8n)
* **Developer Guide** - Fork, customize, contribute
* **Impact & Future** - Educational results + roadmap

***

### 🏅 Hackathon Tracks

#### 🎮 Make Learning Fun

TV-style interface with full gamification system

#### 🤖 Automate Learning

AI-generated topics, quizzes, and instant grading

#### 🔮 Built with Wolfram

Advanced math computation and step-by-step solutions

#### 📚 Built with GitBook

30+ pages of professional documentation

#### ⚡ Built with Cline CLI

Accelerated development workflow

***

### 🚀 Get Started

#### For Students & Parents

1. Visit <https://iavendas62-collab.github.io/learnai-tv/>
2. Click any subject (Math, Portuguese, Science, etc)
3. Choose an activity (Study, Chat, Quiz, Challenge)
4. Start learning and earning points!

#### For Teachers

1. Try the platform with your class
2. Contact us to customize curriculum (Google Docs)
3. Get free pilot program support

#### For Developers

1. Fork: <https://github.com/iavendas62-collab/learnai-tv>
2. Read Developer Guide
3. Submit PRs or open issues

***

### 🤝 Join the Movement

**LearnAI TV is more than an app—it's a movement to make education accessible, engaging, and effective for every student on Earth.**

#### Ways to Get Involved

* ⭐ **Star on GitHub** - Help with visibility
* 🍴 **Fork the repo** - Build your own version
* 🐛 **Report bugs** - Help us improve
* 💡 **Suggest features** - Shape the roadmap
* 🌍 **Translate** - Reach more students globally
* 🏫 **Deploy in schools** - Contact for partnerships

***

### 📞 Contact

**Name:** Pedro Marcelo\
**Email:** <iavendas62@gmail.com>\
**GitHub:** [@iavendas62-collab](https://github.com/iavendas62-collab)\
**Discord:** CS Girlies Hackathon Server

***

### 🏆 Competing For

* 💰 **Overall Winner** - $1,000 + Cline credits
* 📚 **Best Documentation** - $500
* 🔮 **Built with Wolfram** - $1,660/year + $500 scholarship
* ⚡ **Built with Cline CLI** - $1,500
* 🥈 **Overall Runner Up** - $250

**Total Potential:** $3,250+ in prizes

***

{% hint style="info" %}
**Built with ❤️ for CS Girlies Hackathon 2025**\
AI 4 Students - Make Learning Cool Again 🚀
{% endhint %}

***

**Last updated:** November 16, 2025


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://iavendas62.gitbook.io/learnai-tv-documentation/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.