ai-tutor
Self-hosted AI tutor and learning assistant for self-study, e-learning, and exam prep. Turn study notes, PDFs, and lecture notes into a chapter learning path an
What is ai-tutor?
Self-hosted AI tutor and learning assistant for self-study, e-learning, and exam prep. Turn study notes, PDFs, and lecture notes into a chapter learning path and a quiz. It only teaches a sentence it can quote. Bring your own model key.
Overview of ai-tutor
What it is
ai-tutor is a self-hosted AI tutor and learning assistant for self-study, e-learning, and exam prep. It turns study notes, PDFs, and lecture notes into a chapter learning path and a quiz. The system only teaches a sentence it can quote from the source material. Users bring their own model key.
Key features
- The lesson cannot outrun the file: a concept or question is stored only when its quote is a continuous excerpt of a source span; anything the model adds is dropped before reaching the course.
- You study in order: the next chapter stays locked, and its lesson is not sent to the browser, until the current quiz is finished.
- The source comes back after you answer: the explanation and the quote appear on the feedback, not on the question.
- It runs without an account: Docker on your machine, an OpenAI-compatible endpoint you choose, and a three-chapter sample that needs no key.
- Supports multiple input types: PDF, Word (.docx), PowerPoint (.pptx), Excel (.xlsx), text, Markdown, HTML, CSV, subtitles (.srt, .vtt), public HTTP/HTTPS pages, YouTube links with public captions, and audio/video sent to a transcription endpoint.
- The pipeline uses three providers: DeepSeek (extract claims, arrange chapters, write lesson and quiz, answer Ask), Jev through OpenRouter (decide whether a copied sentence supports the claim), and Azure (read text from documents and images).
Use cases
This project is designed for self-study, e-learning, and exam preparation. It can be used by individuals who want to turn their own study notes, PDFs, or lecture notes into a structured learning path with quizzes. It is also suitable for educators or learners who want a grounded AI tutor that only teaches from verified source material, preventing hallucination.
Getting started
bashgit clone https://github.com/lynote-ai/ai-tutor.gitcd ai-tutorcp .env.example .env # Windows: Copy-Item .env.example .envdocker compose up --buildOpen http://127.0.0.1:8080 and choose Try 3 samples. Check health with:bashcurl http://127.0.0.1:8080/api/health
License and pricing
The license is MIT. The pricing type is open source. No pricing information is stated beyond the license.
Based on the project's public README and repository metadata.