featured projectActiveAug 2026 - PresentUpdated Nov 2026

Nexus

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 — project cover
vision

The ultimate learning portal

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.

01

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.

02

Active over passive

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.

03

Own your data and stack

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.

Why it stands out

The decisions, trade-offs, and details that make Nexus worth your time.

01

A grounded tutor, practice loop and cross-topic learning dashboard

02

One topic ingests 20+ source formats, including scanned pages, audio, video, web and YouTube

03

Answers stream with inline citations and an inspector; vision, diagram and equation modes included

04

FSRS-scheduled flashcards, quizzes, dictation, pronunciation and CEFR progress from the same sources

05

Self-hosted and exportable, with roles, read-only share links, REST API, MCP and CLI

From sources to knowledge that sticks

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.

One topic, many inputs

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.

Grounded answers you can inspect

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.

Practice is first-class

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.

Personas and domain packs

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.

A learning dashboard

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.

Study together

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.

Offline review

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.

Self-hosted and exportable

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.

Open surfaces

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.

Capture → learn → practise → retain

Each stage feeds the next: the sources ground the tutor, the tutor feeds practice, and practice schedules what comes back.

01

Capture

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.

02

Learn

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.

03

Practise

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.

04

Retain

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.

Architecture

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 hybrid

Tech stack

End-to-end TypeScript, self-hosted, and provider-agnostic by design — with the queue, retrieval and practice engine chosen for a single-owner deployment.

ReactTypeScripttRPCExpressDrizzle ORMPostgreSQLpgvectorBullMQPWA

Licensed under MIT.

Repositorygithub.com/Pranesh-Selvaraj/Nexus
LicenseMIT
Latest releasev0.4.14 — Docker + GHCR
FrontendReact 18 + Vite 8 + TypeScript + Tailwind 4 (tRPC v11, TanStack Query v5)
BackendNode.js + Express 5, tRPC, Drizzle ORM, LangChain text splitters, OpenAI SDK
QueueBullMQ on Redis 7 — indexing, media, speech and nightly maintenance jobs
SearchPostgreSQL 16 + pgvector with per-dimension HNSW indexes + full-text ts_rank
IngestionPDF, EPUB, DOCX, PPTX, XLSX, ODT, RTF, HTML, Markdown, CSV/JSON, SRT/VTT, ZIP, images, audio, video; tesseract OCR
AIOpenAI-compatible chat, vision, embeddings, STT and TTS; local models supported
PracticeFSRS flashcards, quizzes, mistake notebook, dictation, pronunciation, vocabulary, CEFR, 5 domain packs
CollaborationReader / editor / owner roles, opt-in registration, expiring and revocable read-only share links
APIREST with scoped keys, MCP server, CLI, webhooks and a Manifest V3 browser share target
StorageLocal disk or S3-compatible driver, 5 GB default quota, 30-day trash, JSON/zip export, pg_dump backups
PWAInstallable with offline review queue and sync-on-reconnect
DeploymentGHCR images + Docker Compose; optional authentication; multi-arch and GPU transcription images
Observabilitypino request logs, Prometheus /metrics, queue admin with retry/drop
Monorepopnpm workspaces + Turborepo
CI/CDTypecheck, lint, build, Vitest, Playwright, smoke suite, gitleaks, CodeQL, pnpm audit

Built in the open. Star it, try it, break it.

Nexus is MIT-licensed and developed in public. Feedback, issues, and contributions are genuinely welcome.