whatisgithub

What is ontologydrivensmartcampusadvisor?

liuhuanyong/ontologydrivensmartcampusadvisor — explained in plain English

Analysis updated 2026-05-18

18PythonAudience · researcherComplexity · 3/5Setup · easy

In one sentence

A Python demo that uses a knowledge graph and rule based reasoning, not machine learning, to recommend courses and careers to students and visually shows each reasoning step.

Mindmap

mindmap
  root((Smart Campus Advisor))
    What it does
      Course recommendations
      Career matching
      Skill gap analysis
    Tech stack
      Python
      Knowledge graph
      vis-network frontend
    Use cases
      Explore rule based reasoning
      Study knowledge graph design
      Try natural language Q and A
    Reasoning
      8 rules
      Traced hops
      Subgraph highlighting
    Audience
      Students learning AI
      Researchers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Study a working example of rule based reasoning over a knowledge graph instead of a machine learning model.

USE CASE 2

Ask example questions like what to take next semester and watch the reasoning steps highlighted on a graph.

USE CASE 3

Use it as a teaching demo for ontology design, entities, relationships, and forward chaining rules.

USE CASE 4

Extend the eight existing rules or the sample data as a starting point for a similar advisor project.

What is it built with?

Pythonvis-networkhttp.server

How does it compare?

liuhuanyong/ontologydrivensmartcampusadvisor1038lab/comfyui-agnes-aiadityaarsharma/wordpress-malware-removal
Stars181818
LanguagePythonPythonPython
Setup difficultyeasyeasymoderate
Complexity3/52/53/5
Audienceresearcherdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Needs only Python 3.10+ and no external dependencies, run main.py for a CLI demo or server.py for the web interface.

The README does not state a license, so the terms for using or redistributing this code are unclear.

So what is it?

This project is a demo of a smart campus advisor that recommends courses and career paths to students using a knowledge graph instead of a machine learning model. The author built it to show how ontology modeling, rule based reasoning, and natural language questions can work together, with every step of the reasoning shown visually on screen. The system stores information about departments, majors, professors, courses, skills, students, and careers, with relationships like which courses a professor teaches, which skills a course teaches, and which career a student is aiming for. On top of this graph sit eight reasoning rules that check things like whether a student has completed the prerequisites for a course, which courses to recommend next, what skills a student is missing for their target career, and which careers a student currently qualifies for based on a skill match of sixty percent or higher. When a student types a question in plain language, such as asking what to take next semester or what career suits them, the system matches the question to one of five intents using keyword matching, figures out which student, course, or career is being discussed, then runs the matching chain of rules over the graph. Each rule logs which nodes and connections it visited, and this trace is used to highlight the reasoning path on an interactive graph shown in the browser, alongside the final answer in plain language. The whole thing is written in pure Python with no third party libraries on the backend, and the small web frontend only pulls in a graph visualization library from a public CDN. It comes with sample data for six departments, eight majors, twelve professors, eighteen courses, and eight students, and ships with twenty example questions you can try after starting the local web server. The author is upfront that this is a demo rather than a production system. The language understanding is basic keyword matching rather than a real language model, all data is hardcoded with no way to save changes, the web server is single threaded, and there is no login system or automated testing. The README lists these gaps along with ideas for improving them, such as adding a real database, a proper web framework, and large language model based question understanding.

Copy-paste prompts

Prompt 1
Explain how the eight reasoning rules in this smart campus advisor decide which courses or careers to recommend.
Prompt 2
Walk me through the eight stage question answering pipeline in advisor.py, from intent detection to the final answer.
Prompt 3
Show me how to add a new entity type and a new rule to this knowledge graph based advisor.
Prompt 4
Suggest how I could replace the keyword based intent recognition here with a real language model.

Frequently asked questions

What is ontologydrivensmartcampusadvisor?

A Python demo that uses a knowledge graph and rule based reasoning, not machine learning, to recommend courses and careers to students and visually shows each reasoning step.

What language is ontologydrivensmartcampusadvisor written in?

Mainly Python. The stack also includes Python, vis-network, http.server.

What license does ontologydrivensmartcampusadvisor use?

The README does not state a license, so the terms for using or redistributing this code are unclear.

How hard is ontologydrivensmartcampusadvisor to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is ontologydrivensmartcampusadvisor for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.