Back to the console

Course Compass

CourseEmerging Technologies, MapĂșa UniversityProject typeGroup projectMy partDocumentation sections 4, 6, and 8, plus the diagramsStackFastAPI, ChromaDB, Ollama

Course Compass is a college course advisor that runs on a student's own computer. It searches CHED and DepEd documents first, so the local language model only answers from what was found.

My part

I wrote documentation sections 4, 6, and 8, fixed parts of the other sections, and made the diagrams. The rest of this page describes the system those sections document.

The question the app answers

A student gives their strand, grades, interests, and career goal, and wants to know which college courses fit. A general chatbot can make things up, so the app first retrieves real passages from official CHED and DepEd documents and then asks the model to answer using only those.

How a request flows

  1. Build the query. The profile is flattened into one sentence used only for searching.
  2. Retrieve. The query is embedded and matched against the stored documents, returning the closest chunks.
  3. Augment. The chunks and the profile go into a fixed prompt that tells the model to use only the retrieved context.
  4. Generate and parse. The model replies with a list, and every item is checked against a schema.

The layers

What each layer does
LayerWhat it does
PresentationA plain HTML and JavaScript form that shows the ranked courses
APIA FastAPI app with health, recommend, and PDF upload endpoints
OrchestrationRuns the stages in order and is the only part that talks to both the vector store and the model
EmbeddingA local embedding model, downloaded once
Vector storeA ChromaDB collection saved on disk
Local modelOllama running on the same machine, with no API key

Why it runs locally

Every cloud dependency was replaced with a local one. Settings such as the model live in a settings file, so a different machine can swap them without code changes.

Next reportTalent Publisher