Zenglian990/AI_Tutor_Release
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.
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 教辅智能体
AIREADME_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
中文文档 | 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_2dcoordinate 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).
- One-shot full-page sheet capture, automatic multiple question detection (
- 🎯 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.
- 🔴 Full-Page Homework Red Ink Batch Grading:
- 🧠 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)
- 📐 Mafs Native Interactive Math & Geometry Canvas:
🍎 2. iOS (iPhone & iPad)
- 🌟 Method A (Recommended · Zero-Certificate · Add to Home Screen in 1s):
- Open Safari on your iPhone/iPad and visit Google Cloud Run: https://ai-tutor-79709693345.asia-east1.run.app
- Tap the Share button 📤 at the bottom of Safari;
- Scroll down and tap "Add to Home Screen" ➔ Tap "Add" at top right;
- The 【曾练专属私教】 native App icon appears on your home screen with immersive full-screen UX and camera support!
- 📦 Method B (IPA Native Package):
- Download ZengLian_AI_Tutor_v1.0.0.ipa
- Install via AltStore, Sideloadly, or Apple Enterprise Certificate.
💻 3. PC Desktop (Windows / Mac / Linux)
- Direct browser access: https://ai-tutor-79709693345.asia-east1.run.app
- Large eye-protection display, keyboard shortcuts, one-click A4 test paper printing preview (
Ctrl+P), and LAN network printer integration.
📸 UI Showcase
🖥️ 1. Modern Guided Tutoring & Concept Mind Maps
Deep step-by-step guidance, hierarchical mind maps, instant traps & clues breakdown, full page checking
📐 2. Immersive Scratchpad & Geometry/Parabola Whiteboard
Handwritten scratchpad, dynamic geometry points, parabola sandbox, and instant "Grade My Scratchpad" AI audit
🗺️ 3. Interactive Gamified Learning Map
Chapter exploration islands, progressive stage unlock, turning repetitive homework into an adventure
🧭 4. Semester Roadmap & Boss Stages
Full semester dungeon overview with clear targets, core theorems, and rigorous geometric proof advice
📝 5. Smart Mistake Notebook & Targeted Variation Sheets
Ebbinghaus review schedules, one-click printable A4 layout, AI-generated variant exercises
📊 6. Parent Supervision & Weekly Learning Diagnostics
Actionable analytics, weak spot identification, customized parenting guidance, printable teacher notes
🎨 7. Social Achievement Posters for WeChat / Social Media
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.
- 5-Step Ground-Truth Vision Chain: Mandatory transcription of original formulas (
- 🎙️ 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.
- Proprietary
- 🖨️ 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.shin your terminal
The script automatically installs required dependencies, builds the frontend, and prompts for your
Gemini API Keybefore openinghttp://localhost:3001in 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