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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/lynote-aiai-tutor.svg)](https://yunodb.com/tools/lynote-aiai-tutor?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/lynote-aiai-tutor?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/lynote-aiai-tutor.svg" alt="Featured on YunoDB" height="20"></a>