Grounded before generative
The model only sees retrieved sources and must cite them. When the material does not contain the answer, the correct behaviour is to say so and point at what might help — never to invent one.
Bring anything you read, watch or photograph. Leave with knowledge that sticks.
A self-hosted learning portal with a grounded AI tutor, deliberate practice, spaced repetition and a dashboard that shows what is actually sticking.
FSRS
Scheduling
20+
Source formats
4
Learning modes
Self-hosted
Docker + GHCR
Nexus exists to make learning anything as effective as working with a great tutor who has read everything you have: grounded in your own material, built around practice rather than passive reading, and running on infrastructure you control.
The model only sees retrieved sources and must cite them. When the material does not contain the answer, the correct behaviour is to say so and point at what might help — never to invent one.
Every reading surface leads to a question, card, quiz or drill. A feature that only displays content is not finished until it connects to practice.
Self-hosting is a product feature: export everything, choose any OpenAI-compatible provider, query through the same API the UI uses, and leave whenever you want.
The decisions, trade-offs, and details that make Nexus worth your time.
A grounded tutor, practice loop and cross-topic learning dashboard
One topic ingests 20+ source formats, including scanned pages, audio, video, web and YouTube
Answers stream with inline citations and an inspector; vision, diagram and equation modes included
FSRS-scheduled flashcards, quizzes, dictation, pronunciation and CEFR progress from the same sources
Self-hosted and exportable, with roles, read-only share links, REST API, MCP and CLI
Nexus makes the topic the unit of the product. Sources ground the tutor, the tutor feeds practice, and spaced repetition decides what comes back — across every topic in one dashboard.
Bring PDFs, EPUBs, slides, spreadsheets, web articles, YouTube transcripts, images, audio and video into one topic. 20+ formats keep their structure where possible, OCR handles scanned pages, and identical files are deduplicated with provenance preserved.
Ask questions and get streamed answers with inline citations. Hybrid pgvector and keyword retrieval — with per-dimension HNSW indexes at scale — keeps answers tied to the source, and the inspector shows candidates, scores and timings so the evidence can be audited.
Turn the same material into flashcards scheduled by FSRS, quizzes with a mistake notebook, dictation with word-level diffs, pronunciation scored per word, vocabulary mining and a CEFR estimate for reading, writing, listening and speaking.
Swap the tutor for a Socratic partner, an explainer, an exam coach, an art critic, a code mentor or a language partner. Five first-party packs — Spanish A1, Python, painting, cell biology and music theory — add a plan, a starter deck and questions.
Home aggregates every topic: cards due now, reviews completed today, a continue-learning row, suggested next steps and recent sources. Each topic has Learn, Practice, Voice and Language modes over the same sources and permissions.
Share a topic with reader, editor or owner roles enforced server-side on every request. Read-only capability links can be labelled, given an expiry and revoked at any time; new accounts start with no access until an owner adds them.
Nexus is an installable PWA. The review screen opens from cache without a connection, accepts ratings, queues them locally and replays them in order when the network returns; speech clips that have already played replay offline.
Run it with Docker Compose and GHCR images. Choose any OpenAI-compatible provider or a local model, store documents on local disk or S3, and export a workspace as JSON or a zip with the original files. Backups use pg_dump with a documented restore drill.
The same REST API with scoped keys powers an MCP server, a CLI, webhooks and a browser share target, so notes, editors and agents can search, ask, upload and review without bypassing the retrieval or permission model.
Each stage feeds the next: the sources ground the tutor, the tutor feeds practice, and practice schedules what comes back.
Upload a document, paste an article or YouTube URL, photograph a page, or add audio or video. Nexus extracts text, structure and provenance, and deduplicates identical files before indexing.
Chat with the topic over WebSocket and get grounded, cited answers. Open the inspector to see why sources were chosen, switch persona, attach an image, dictate a question or listen to an answer.
Generate flashcards, quizzes, dictation and pronunciation drills from the same material, install a domain pack for a running start, and work through a plan the pack provides.
FSRS schedules each card at the moment it is about to be forgotten. The dashboard tracks due work, reviews and progress across every topic, offline and on reconnect.
React 18 + tRPC ── HTTP /trpc + WS /ws ──▶ Express 5 + tRPC
│ │
│ ├─▶ BullMQ (Redis 7) ──▶ parse · OCR · embed
│ │
└── PWA shell · offline review └─▶ PostgreSQL 16 + pgvector
HNSW ANN + full-text hybridEnd-to-end TypeScript, self-hosted, and provider-agnostic by design — with the queue, retrieval and practice engine chosen for a single-owner deployment.
Licensed under MIT.
Nexus is MIT-licensed and developed in public. Feedback, issues, and contributions are genuinely welcome.