# shashist/recsys-course architecture

> Architecture diagram of the GitHub repository shashist/recsys-course, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/shashist/recsys-course
- Repository: https://github.com/shashist/recsys-course

## Overview

This repository is a course-materials collection, not a running recommender system. The learner workflow is to consult the syllabus, study the lecture and seminar materials, then complete the listed homeworks. The README documents the course topics and links to each artifact; source excerpts were unavailable, so relationships below reflect only those documented links.

Main entry points: [`README.md`](https://github.com/shashist/recsys-course/blob/main/README.md) (Syllabus), [`week_01_introduction/rs_lecture01.pdf`](https://github.com/shashist/recsys-course/blob/main/week_01_introduction/rs_lecture01.pdf) (Introduction), [`week_02_neighbourhood_based/rs_lecture02.pdf`](https://github.com/shashist/recsys-course/blob/main/week_02_neighbourhood_based/rs_lecture02.pdf) (Neighborhood Models), [`week_02_neighbourhood_based/rs_seminar1.ipynb`](https://github.com/shashist/recsys-course/blob/main/week_02_neighbourhood_based/rs_seminar1.ipynb) (Neighborhood Seminar)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_course["Course Guide"]
  node_guide["Syllabus<br/>[README.md]"]
end

subgraph group_recommendation["Recommender Methods"]
  node_intro["Introduction<br/>[rs_lecture01.pdf]"]
  node_neighborhood["Neighborhood Models<br/>[rs_lecture02.pdf]"]
  node_neighborhood_seminar["Neighborhood Seminar<br/>[rs_seminar1.ipynb]"]
  node_matrix_factorization["Matrix Factorization<br/>[rs_lecture03.pdf]"]
  node_hybrid["Content and Hybrid<br/>[rs_lecture04.pdf]"]
  node_neural["Neural Recommenders<br/>[rs_lecture05.pdf]"]
  node_two_level["Two-Level Models"]
end

subgraph group_evaluation["Bandits Evaluation"]
  node_bandits["Multi-Armed Bandits<br/>[rs_lecture07.pdf]"]
  node_counterfactual["Counterfactual Evaluation<br/>[rs_lecture08.pdf]"]
end

subgraph group_assignments["Homeworks"]
  node_bandits_homework["Bandits Homework"]
  node_als_homework["ALS Homework<br/>[hw_als.ipynb]"]
end

node_learner(("Learner"))

node_learner -->|"consults"| node_guide
node_guide -->|"lists"| node_intro
node_guide -->|"lists"| node_neighborhood
node_guide -->|"lists"| node_neighborhood_seminar
node_guide -->|"lists"| node_matrix_factorization
node_guide -->|"lists"| node_hybrid
node_guide -->|"lists"| node_neural
node_guide -->|"lists"| node_two_level
node_guide -->|"lists"| node_bandits
node_guide -->|"lists"| node_counterfactual
node_guide -->|"assigns"| node_bandits_homework
node_guide -->|"assigns"| node_als_homework

click node_guide "https://github.com/shashist/recsys-course/blob/main/README.md"
click node_intro "https://github.com/shashist/recsys-course/blob/main/week_01_introduction/rs_lecture01.pdf"
click node_neighborhood "https://github.com/shashist/recsys-course/blob/main/week_02_neighbourhood_based/rs_lecture02.pdf"
click node_neighborhood_seminar "https://github.com/shashist/recsys-course/blob/main/week_02_neighbourhood_based/rs_seminar1.ipynb"
click node_matrix_factorization "https://github.com/shashist/recsys-course/blob/main/week_03_matrix_factorization/rs_lecture03.pdf"
click node_hybrid "https://github.com/shashist/recsys-course/blob/main/week_04_hybrid/rs_lecture04.pdf"
click node_neural "https://github.com/shashist/recsys-course/blob/main/week_05_neural_recommenders/rs_lecture05.pdf"
click node_two_level "https://github.com/shashist/recsys-course/blob/main/week_06_two-level/rs_seminar_2-level.ipynb"
click node_bandits "https://github.com/shashist/recsys-course/blob/main/week_07_bandits/rs_lecture07.pdf"
click node_counterfactual "https://github.com/shashist/recsys-course/blob/main/week_08_counterfactual/rs_lecture08.pdf"
click node_bandits_homework "https://github.com/shashist/recsys-course/blob/main/homeworks/hw_bandits/rs_hw_bandits_en.pdf"
click node_als_homework "https://github.com/shashist/recsys-course/blob/main/homeworks/hw_als/hw_als.ipynb"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_guide toneBlue
class node_intro,node_neighborhood,node_neighborhood_seminar,node_matrix_factorization,node_hybrid,node_neural,node_two_level toneAmber
class node_bandits,node_counterfactual toneMint
class node_bandits_homework,node_als_homework toneRose
class node_learner toneIndigo
```

## Components

### Course Guide

- [Syllabus](https://github.com/shashist/recsys-course/blob/main/README.md): `README.md`

### Recommender Methods

- [Introduction](https://github.com/shashist/recsys-course/blob/main/week_01_introduction/rs_lecture01.pdf): `week_01_introduction/rs_lecture01.pdf`
- [Neighborhood Models](https://github.com/shashist/recsys-course/blob/main/week_02_neighbourhood_based/rs_lecture02.pdf): `week_02_neighbourhood_based/rs_lecture02.pdf`
- [Neighborhood Seminar](https://github.com/shashist/recsys-course/blob/main/week_02_neighbourhood_based/rs_seminar1.ipynb): `week_02_neighbourhood_based/rs_seminar1.ipynb`
- [Matrix Factorization](https://github.com/shashist/recsys-course/blob/main/week_03_matrix_factorization/rs_lecture03.pdf): `week_03_matrix_factorization/rs_lecture03.pdf`
- [Content and Hybrid](https://github.com/shashist/recsys-course/blob/main/week_04_hybrid/rs_lecture04.pdf): `week_04_hybrid/rs_lecture04.pdf`
- [Neural Recommenders](https://github.com/shashist/recsys-course/blob/main/week_05_neural_recommenders/rs_lecture05.pdf): `week_05_neural_recommenders/rs_lecture05.pdf`
- [Two-Level Models](https://github.com/shashist/recsys-course/blob/main/week_06_two-level/rs_seminar_2-level.ipynb): `week_06_two-level/rs_seminar_2-level.ipynb`

### Bandits Evaluation

- [Multi-Armed Bandits](https://github.com/shashist/recsys-course/blob/main/week_07_bandits/rs_lecture07.pdf): `week_07_bandits/rs_lecture07.pdf`
- [Counterfactual Evaluation](https://github.com/shashist/recsys-course/blob/main/week_08_counterfactual/rs_lecture08.pdf): `week_08_counterfactual/rs_lecture08.pdf`

### Homeworks

- [Bandits Homework](https://github.com/shashist/recsys-course/blob/main/homeworks/hw_bandits/rs_hw_bandits_en.pdf): `homeworks/hw_bandits/rs_hw_bandits_en.pdf`
- [ALS Homework](https://github.com/shashist/recsys-course/blob/main/homeworks/hw_als/hw_als.ipynb): `homeworks/hw_als/hw_als.ipynb`

### Other components

- **Learner**

## Connections

- Learner → Syllabus: consults (evidence: `README.md`)
- Syllabus → Introduction: lists (evidence: `README.md`)
- Syllabus → Neighborhood Models: lists (evidence: `README.md`)
- Syllabus → Neighborhood Seminar: lists (evidence: `README.md`)
- Syllabus → Matrix Factorization: lists (evidence: `README.md`)
- Syllabus → Content and Hybrid: lists (evidence: `README.md`)
- Syllabus → Neural Recommenders: lists (evidence: `README.md`)
- Syllabus → Two-Level Models: lists (evidence: `README.md`)
- Syllabus → Multi-Armed Bandits: lists (evidence: `README.md`)
- Syllabus → Counterfactual Evaluation: lists (evidence: `README.md`)
- Syllabus → Bandits Homework: assigns (evidence: `README.md`)
- Syllabus → ALS Homework: assigns (evidence: `README.md`)
