Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

History

2 Commits

Repository files navigation

graph_tutor

An AI-agent-tutored curriculum for learning graph and vector databases by building a CS/AI/ML knowledge base in Neo4j.

What You'll Learn

12 progressive lessons that take you from graph fundamentals to GraphRAG:

#Topic
1Graph Databases 101 — nodes, edges, labels, the graph data model
2Neo4j Setup + Your First Nodes — CREATE, properties, labels
3Relationships — directed edges, relationship types, topology
4Querying with Cypher — MATCH, WHERE, filtering, projection
5Building the Knowledge Graph — MERGE, UNWIND, schema design
6Pattern Matching and Traversal — variable-length paths, subgraphs
7Graph Algorithms — centrality, PageRank, community detection
8Vector Search Fundamentals — embeddings, semantic meaning, distance
9Neo4j Vector Indexes — HNSW, index configuration
10Similarity Search — KNN queries, semantic retrieval
11Hybrid Graph + Vector Search — combining structure and semantics
12GraphRAG — retrieval-augmented generation with graph context

How It Works

An AI tutor agent guides you through each lesson, explaining concepts before code, checking your understanding, and building a running knowledge base that grows across all 12 lessons. No skipping fundamentals — everything is explained from first principles.

Stack

  • Database: Neo4j 5.x+ (run via Docker)
  • Query Language: Cypher
  • Plugins: APOC, GDS
  • Interface: Neo4j Browser (localhost:7474) or cypher-shell

Prerequisites

  • Docker (for running Neo4j)
  • Neo4j 5.x+ with APOC plugin
  • No prior graph database experience needed

Quick Start

# Start Neo4j
docker compose up -d
# Open the browser
open http://localhost:7474

Then follow the lessons in TUTOR.md with the AI tutor agent.

Project Files

  • TUTOR.md — The 12-lesson curriculum and agent system prompt
  • AGENT.md — Cypher conventions, Neo4j setup, and teaching rules

Design Decisions

  • CS/AI/ML knowledge base as the running example — you're building a graph about the domain you're studying
  • Neo4j native vectors over external vector DB — one tool to learn, demonstrates graph+vector integration
  • Pre-computed embeddings over live API calls — focus stays on database concepts, not ML plumbing
  • GraphRAG as finale — shows the convergence of graph and vector search in modern AI applications

About

opencode tutor led course for learning about graph and vector DB concepts. Users will use the project agent to follow the course and learn about graph DB concepts by building a project

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors