Skip to content
Projects

Zenglian990/AI_Tutor_Release has 94 GitHub stars and 30 forks. GitHot measured 0 stars in 24 hours and +6 in 7 days. Last checked 2026-11-16 20:13 UTC. Last push 2026-11-10.

How these counts are measured

What you can do

  • 五步视觉转录锚定:前置强制完整输出 ### 📝 【原题精确还原】,彻底杜绝看错符号、漏看已知条件的视觉幻觉,后续考点分析、草稿纸第一步动笔支架、推导与变式母题环环相扣。
  • 开图即扫与题目胶囊:整页试卷静默后台毫秒级自动分题,顶部展现一键吸附题目标签胶囊([全页]、[第1题]、[第2题]...),点击即自动平滑包围目标题目。
  • 触控悬浮微调放大镜(Loupe):拖拽边角把手时上方实时唤出 2.2x 放大镜及绿色十字准星,手指不再挡字。
  • 切片无损直通:彻底拦截二次重绘压缩,保证高清公式与几何图细节直达大模型。

Measured star growth

in 24h
0
in 7 days
+6
in 15 days
Update delayed
in 1 month
Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

EduAgent: Open-Source RAG AI Tutor for K-9 Education. 国内首个专为1-9年级量身定制的开源 RAG AI 教辅智能体

AI

README_en.md

Original

🎓 ZengLian AI Tutor (曾练专属私教)

The Next-Gen Open-Source RAG AI Tutoring System specifically tailored for K-9 Education Comprehensive K-9 Textbooks Knowledge Base · Dual-Modal Adaptive Mind Engines · Closed-Loop Learning System


Download APK Download IPA Online Web Release


React Node.js Mobile Dual RAG LLM License: MIT

中文文档 | English | 🤖 Android APK (v1.7.3 Full-Page Batch Grading·39k Grounding·Ergonomics) | 🍎 iOS Guide | 🌐 Cloud Web

"Education equality is not just a slogan. We aim to bring top-tier AI private tutors to every ordinary household."


📱 Multi-Platform Support (Android / iOS / PC)

Zero complicated dev setup required. Enjoy seamless, synchronized tutoring across mobile phones, tablets, and desktop computers:

🤖 1. Android (Phone & Tablet)

  • 📥 Direct APK Download: AI_Tutor_v1.7.3.apk (~4.5MB · Full-Page Batch Grading · 39,114 Canonical Question Grounding · Mobile Ergonomics)
  • 📥 Stable Fallback: AI_Tutor_v1.6.3.apk (~10.5MB · FSRS Scientific Memory Scheduler · Interactive Math Canvas · Feynman Peer Mode)
  • ✨ v1.7.3 Major Milestone Upgrades (Batch Grading & 39k Grounding & Ergonomics):
    • 🔴 Full-Page Homework Red Ink Batch Grading:
      • One-shot full-page sheet capture, automatic multiple question detection (box_2d coordinate bounding);
      • Teacher red ink overlay (✓/✕/step score line), high-precision slice review, and one-click mistake notebook archiving;
      • Multi-provider intelligent routing prioritizing domestic vision models (SiliconFlow / DashScope / Zhipu).
    • 🎯 39,114 National Benchmark Exam Canonical Grounding Bank:
      • Millisecond exact fingerprint & fuzzy keyword anchoring eliminating LLM calculation hallucinations.
    • 📱 Mobile Ergonomics & Responsive Layout Optimization:
      • Zero horizontal crowding or overflow on grade selectors; optimized thumb reach for bottom input bars.
    • 🖨️ Dynamic A4 Paper Layout & In-Modal Feynman Dialogue:
      • Automatic page count adaptation (1/2/4 pages) and in-modal multi-turn reflective Feynman tutoring.
  • 🧠 Continued support for v1.6.3 FSRS-v4.5 Modern Memory Scheduler & Mafs Canvas:
    • 📐 Mafs Native Interactive Math & Geometry Canvas:
      • Gesture-draggable parabola and triangle explorers that link formula manipulation directly with spatial geometry.
    • 🧑‍🤝‍🧑 Feynman "Virtual Peer" Roleplay System:
      • Students teach curious peer Xiao Ming; automatic 3D grading on Accuracy (40%), Logic (35%), and Analogy (25%).
    • 📍 Persistent Study Checkpoint Resume Engine:
      • Remembers precisely where the student paused, unanswered doubts, and upcoming learning goals. Never restarts explanations from scratch!
    • 🏛️ Socratic Scaffolding Gatekeeper:
      • Enforces Discovery ➔ Scaffolding ➔ Consolidation flow, rejecting lazy direct answer dumps.
    • 🧠 L1-L3 Auditable Cognitive State Evolution:
      • Continuously measures mastery scores (0.0 - 1.0) and dynamically pinpoints prerequisite knowledge gaps. (Releases strictly maintain the 2 latest APK packages: v1.6.3 & v1.6.2)

🍎 2. iOS (iPhone & iPad)

  • 🌟 Method A (Recommended · Zero-Certificate · Add to Home Screen in 1s):
    1. Open Safari on your iPhone/iPad and visit Google Cloud Run: https://ai-tutor-79709693345.asia-east1.run.app
    2. Tap the Share button 📤 at the bottom of Safari;
    3. Scroll down and tap "Add to Home Screen" ➔ Tap "Add" at top right;
    4. The 【曾练专属私教】 native App icon appears on your home screen with immersive full-screen UX and camera support!
  • 📦 Method B (IPA Native Package):

💻 3. PC Desktop (Windows / Mac / Linux)


📸 UI Showcase

🖥️ 1. Modern Guided Tutoring & Concept Mind Maps

Guided Tutoring & Main Interface

Deep step-by-step guidance, hierarchical mind maps, instant traps & clues breakdown, full page checking


📐 2. Immersive Scratchpad & Geometry/Parabola Whiteboard

Interactive Scratchpad and Whiteboard

Handwritten scratchpad, dynamic geometry points, parabola sandbox, and instant "Grade My Scratchpad" AI audit


🗺️ 3. Interactive Gamified Learning Map

Gamified Learning Map

Chapter exploration islands, progressive stage unlock, turning repetitive homework into an adventure


🧭 4. Semester Roadmap & Boss Stages

Semester Roadmap

Full semester dungeon overview with clear targets, core theorems, and rigorous geometric proof advice


📝 5. Smart Mistake Notebook & Targeted Variation Sheets

Mistake Notebook & Practice Sheets

Ebbinghaus review schedules, one-click printable A4 layout, AI-generated variant exercises


📊 6. Parent Supervision & Weekly Learning Diagnostics

Parent Supervision Dashboard

Actionable analytics, weak spot identification, customized parenting guidance, printable teacher notes


🎨 7. Social Achievement Posters for WeChat / Social Media

Social Achievement Poster

High-aesthetic social poster rendering with personal QR codes and motivational quotes


🌟 Core Features

ZengLian AI Tutor eliminates the drawbacks of traditional "homework search engines" that encourage rote copying. Utilizing large language models and LanceDB textbook vector knowledge bases, it establishes a true "Learn - Practice - Test - Guide - Manage" closed-loop tutoring agent:

  • 📸 Industrial Photo Question Search & OCR Grounding:
    • 5-Step Ground-Truth Vision Chain: Mandatory transcription of original formulas (### 📝 【原题精确还原】) using LaTeX before derivation to eradicate hallucinated numbers or missed minus signs; seamlessly followed by clue breakdown, draftpad scaffolding, derivation, and parallel variations.
    • Zero-Click Layout Analysis & Question Selection Carousel: Instant background parsing generates [Full Page], [Q1], [Q2] pill buttons for one-tap bounding box snapping.
    • Touch Precision Floating Loupe: 2.2x circular magnifier hovering 70px above fingertip with green crosshairs for pixel-perfect corner adjustments without thumb obstruction.
    • Lossless Direct Image Pipeline: Eliminates client-side double-compression degradation, preserving crisp mathematical superscripts and geometry lines.
  • 🎙️ Triple-Engine Ultra-Fast Voice Input (Sub-Second Latency):
    • Native Web Speech API: Real-time 0-latency live streaming transcription on Android Chrome and desktop.
    • Voice Activity Detection (VAD): 900ms silence auto-cutoff for hands-free natural speaking.
    • 0-Thinking Server Fallback: Sub-second server STT pipeline with thinkingBudget: 0.
  • ⚡ Dual Ultra-Fast AI Engines (User Freedom & Strict Execution):
    • DeepSeek-V3 Fast Edition: Ultra-low Time-To-First-Token (TTFT ~0.4s) via domestic low-latency channels, crisp and responsive instant streaming.
    • Gemini 2.5 Flash Deep Edition: Native multimodal vision processing, geometric diagram comprehension, and complex multi-step reasoning.
    • Instant One-Click Toggle: Prominently accessible header capsule switch (【⚡ Fast / 🧠 Gemini】), strictly adhering to user selection without model spoofing.
  • 🧠 Jev K-9 Cognitive Mental Engine (Automatic Grade Matching):
    • Grades 1-3 (Playful & Concrete): Engaging tone, situational recitations, visual breakdowns, focus nurturing.
    • Grades 4-6 (Order & Calculation Discipline): Structured scratchpad practice, step verification, mistake taxonomy.
    • Grades 7-9 (Rigorous Logic & High School Prep): Concept mind maps, counter-questioning, rigorous geometric/algebraic proofs.
    • Zero Manual Overhead: Automatically maps the student's selected grade to developmental strategies; embedded local 0ms heuristic engine intercepts off-topic banter and scaffold frustration.
  • 🌊 45ms RAF Smooth Streaming Buffer:
    • Proprietary requestAnimationFrame-based 45ms frame buffer, eliminating DOM jitter and frame drops during high-speed token generation for a butter-smooth typewriter experience.
  • 🖨️ Printable A4 Exam Papers & 39,114+ National Exam Question Bank:
    • Built-in 39,114+ core curriculum and top-school mock exam questions, one-click export to standard A4 test papers and targeted mistake variation sheets for offline practice.
  • 🗣️ Socratic Heuristic Tutoring:
    • Guides students step-by-step rather than spoon-feeding final answers.
    • Features real-time Text-to-Speech (TTS), draft scratchpad, geometry whiteboard, instant full-page correction, and trap analysis.
  • 🗺️ Gamified Knowledge Graph:
    • Maps complete textbook curricula into explorable stages and dungeons with progressive locks.
  • 📒 Mistake Closed Loop & Targeted Variation Practice:
    • Automatically captures flawed concepts, generates parallel variations, and exports clean A4 test papers.
  • 📊 Parent Supervision & Academic Diagnosis:
    • Generates comprehensive weekly reports with personalized parent follow-up recommendations.
  • 📱 Cross-Platform Access & Safe Area Protection:
    • Web Application: Immersive desktop multi-window experience.
    • Native Android APK: Tailored for 9:16 portrait phones with edge-to-edge gesture bar clearance.

🛠️ Tech Stack

graph TD
    UserApp[📱 Native Android APK / 💻 Web Browser] -->|45ms RAF Stream Buffer| ClientUI[Client Immersive UI]
    ClientUI -->|API Requests| Server(Node.js / Express Server)
    Server -->|Local 0ms Routing| JevEngine[🧠 Jev K-9 Cognitive Brain]
    JevEngine -->|Grade-Adaptive Prompts / Frustration Guard| ModelRouter{User Dual-Engine Selector}
    ModelRouter -->|⚡ Fast TTFT 0.4s| DeepSeek[DeepSeek-V3 Engine]
    ModelRouter -->|🧠 Multimodal Deep Reasoning| Gemini[Gemini 2.5 Flash Engine]
    Server -->|Textbooks & Exam RAG| LanceDB[(LanceDB Vector DB / 39,114+ Questions)]
    LanceDB -->|Fast Embeddings| PythonRAG[Python RAG Multimodal Ingestion]
    PythonRAG -->|OCR & Chunking| Textbooks[K-9 Textbooks & National Exam Bank]

🚀 Quick Start for PC

With our automated startup scripts, you DO NOT need to manually configure complicated dependencies.

1. Clone the repository

git clone https://github.com/Zenglian990/AI_Tutor_Release.git
cd AI_Tutor_Release

2. One-Click Start (Fully Automated)

  • Windows: Double-click 启动AI辅导.bat
  • Mac/Linux: Execute sh start.sh in your terminal

The script automatically installs required dependencies, builds the frontend, and prompts for your Gemini API Key before opening http://localhost:3001 in your browser.


🤝 Contributing

Contributions are warmly welcomed! Whether you are a developer, an educator, or a parent, feel free to open a Pull Request or file an Issue.


Built with ❤️ by Zeng Lian & the Open Source Community