Skip to content
@tramplinn

tramplinn

README.md
Tramplin

Tramplin

Knowledge turns into practice

A learning platform with courses, quizzes, runnable coding problems, and an AI tutor next to every lesson.

Python FastAPI Vue TypeScript PostgreSQL RabbitMQ Redis Docker Caddy Grafana

Why

Classes still revolve around slides and copying lectures into notebooks. Code from a lecture can't be run, mistakes only show up at the exam, and if a topic doesn't click, you wait until the next class.

In Tramplin, the material is already online, so class time goes to discussion and practice. Code runs in the browser, quizzes are graded instantly, and the AI tutor is there 24/7. Teachers prepare lessons with an AI assistant and MCP agents, and the college keeps its own platform and data. More in the business value doc.

How it works

Learn Check yourself Practice Teach
A course map shows the path; you pick up where you left off Quizzes with different question types, and an AI tutor that knows the lesson Problem, editor, and run button on one screen; code runs in a Piston sandbox Lesson editor with live preview, plus AI agents that fill courses via MCP
Course map
Course map of "Fullstack Development" with student progress
More screenshots: lesson, quiz, AI tutor, problems, editor, people
Lesson
Lesson with Markdown and code highlighting		 Interactive quiz
Interactive drag-and-drop quiz
AI tutor
AI tutor		 Solving a problem
Algorithm problem: code, run, submit
Lesson editor
Lesson editor with preview		 People
Platform user profiles

Under the hood

Product
frontend — the web app for students, teachers, and admins
Vue 3 · TypeScript · Vite · Pinia · TanStack Query · CodeMirror
backend — API, auth, courses, progress, recommendations, AI tutor; the only service with database access
Python 3.14 · FastAPI · SQLAlchemy · Dishka · FastStream · pgvector
email-service — sends emails from a queue over SMTP
Python · FastStream · RabbitMQ · aiosmtplib
AI agents
mcp-server — lets Codex, Claude Code, and other agents fill courses on a teacher's behalf
FastMCP · httpx · OAuth 2.1 + PKCE
Platform
infra — proxy, queues, code sandbox, logs, and metrics for stage and prod
Docker Compose · Caddy · RabbitMQ · Piston · Prometheus / Loki / Grafana / Alloy
Knowledge
specs — business value, products, use cases, and upcoming changes
Markdown
Tramplin architecture diagram

Getting started

I want to… Go to
understand the product business value → products → use cases by role
run it locally in backend: make up && make migrate && make seed && make run, then in frontend: pnpm install --frozen-lockfile && pnpm dev → http://localhost:5173
connect an AI agent mcp-server, sign in as a teacher

Popular repositories Loading

  1. backend backend Public

    Backend for Tramplin - learning platform API: courses, lessons, quizzes, progress, authoring, OAuth, S3 files, AI tutor and algorithm task runner. Python 3.14 + FastAPI.

    Python

  2. frontend frontend Public

    Web UI for Tramplin - course catalog with module maps, lessons, interactive quizzes, progress, profiles, authoring and algorithm practice. Vue 3 + TypeScript + Vite.

    Vue

  3. email-service email-service Public

    Email delivery worker for Tramplin - consumes jobs from RabbitMQ and sends them via SMTP; templates are rendered by the backend.

    Python

  4. mcp-server mcp-server Public

    MCP server for Tramplin - FastMCP service that lets AI agents author course content through the public authoring API.

    Python

  5. infra infra Public

    Infrastructure for Tramplin - Caddy (TLS, reverse proxy), PostgreSQL + pgvector, Redis, RabbitMQ and Grafana, deployed via Docker Compose for staging and production.

    Shell

  6. specs specs Public

    Specs for Tramplin - product vision, use cases and business value of the learning platform. One of 6 repos.

Repositories

Showing 7 of 7 repositories

Top languages

Loading…

Most used topics

Loading…