# neo4j-graphacademy/llm-vectors-unstructured architecture

> Architecture diagram of the GitHub repository neo4j-graphacademy/llm-vectors-unstructured, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/neo4j-graphacademy/llm-vectors-unstructured
- Repository: https://github.com/neo4j-graphacademy/llm-vectors-unstructured

## Overview

This is a GraphAcademy course repository demonstrating vector indexes and unstructured-data workflows with Neo4j, rather than a single deployed application. The main example loads AsciiDoc lessons, chunks them, creates embeddings and stores course structure in Neo4j; a query example embeds a question and searches a vector index. Topic extraction, vector-store setup, and Quora and poster embedding examples are additional branches. Several starter scripts are intentionally incomplete, and some branches are documented by the tree but not shown in source excerpts, so their relationships are omitted.

Main entry points: [`llm-vectors-unstructured/solutions/build_graph.py`](https://github.com/neo4j-graphacademy/llm-vectors-unstructured/blob/main/llm-vectors-unstructured/solutions/build_graph.py) (Load and chunk), [`llm-vectors-unstructured/solutions/build_graph_topics.py`](https://github.com/neo4j-graphacademy/llm-vectors-unstructured/blob/main/llm-vectors-unstructured/solutions/build_graph_topics.py) (Topic graph writer), [`llm-vectors-unstructured/solutions/query_neo4j.py`](https://github.com/neo4j-graphacademy/llm-vectors-unstructured/blob/main/llm-vectors-unstructured/solutions/query_neo4j.py) (Vector query example), [`llm-vectors-unstructured/solutions/poster_embeddings.py`](https://github.com/neo4j-graphacademy/llm-vectors-unstructured/blob/main/llm-vectors-unstructured/solutions/poster_embeddings.py) (Poster embeddings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Course content"]
  node_lessons["Lesson corpus"]
end

subgraph group_ingest["Ingestion examples"]
  node_load_chunk["Load and chunk<br/>[build_graph.py]"]
  node_course_data["Course metadata<br/>[build_graph.py]"]
  node_embed_text["Text embeddings<br/>[build_graph.py]"]
  node_graph_writer["Course graph writer<br/>[build_graph.py]"]
  node_topic_graph["Topic graph writer"]
  node_neo4j[("Neo4j database")]
  node_starter_graph["Graph starter<br/>[build_graph.py]"]
  node_starter_embed["Embedding starter"]
end

subgraph group_search["Vector search"]
  node_query_example["Vector query example<br/>[query_neo4j.py]"]
  node_vector_store["Vector store setup<br/>[create_vector.py]"]
  node_starter_vector["Vector starter<br/>[create_vector.py]"]
  node_starter_query["Query starter<br/>[query_neo4j.py]"]
end

subgraph group_extras["Additional examples"]
  node_topic_demo["Topic extraction demo<br/>[extract_topics.py]"]
  node_quora_filter["Quora filtering<br/>[quora_filter.py]"]
  node_quora_embed["Quora embeddings"]
  node_poster_embed["Poster embeddings"]
end

node_learner(("Course learner"))
node_openai["OpenAI embeddings"]

node_learner -->|"studies"| node_lessons
node_lessons -->|"loads and chunks"| node_load_chunk
node_load_chunk -->|"passes chunks"| node_course_data
node_course_data -->|"requests embeddings"| node_embed_text
node_embed_text -->|"calls embeddings"| node_openai
node_course_data -->|"supplies metadata"| node_graph_writer
node_load_chunk -->|"dispatches writes"| node_graph_writer
node_graph_writer -->|"writes graph"| node_neo4j
node_topic_graph -->|"writes topics"| node_neo4j
node_topic_graph -->|"requests embeddings"| node_openai
node_query_example -->|"embeds question"| node_openai
node_query_example -->|"queries index"| node_neo4j
node_vector_store -.->|"configures store"| node_neo4j
node_quora_embed -->|"requests embeddings"| node_openai
node_poster_embed -->|"reads movie posters"| node_neo4j
node_poster_embed -.->|"uses image model"| node_openai
node_starter_graph -.->|"planned graph write"| node_neo4j
node_starter_query -.->|"planned query"| node_neo4j

click node_lessons "https://github.com/neo4j-graphacademy/llm-vectors-unstructured/tree/main/llm-vectors-unstructured/data/asciidoc"
click node_load_chunk "https://github.com/neo4j-graphacademy/llm-vectors-unstructured/blob/main/llm-vectors-unstructured/solutions/build_graph.py"
click node_course_data "https://github.com/neo4j-graphacademy/llm-vectors-unstructured/blob/main/llm-vectors-unstructured/solutions/build_graph.py"
click node_embed_text "https://github.com/neo4j-graphacademy/llm-vectors-unstructured/blob/main/llm-vectors-unstructured/solutions/build_graph.py"
click node_graph_writer "https://github.com/neo4j-graphacademy/llm-vectors-unstructured/blob/main/llm-vectors-unstructured/solutions/build_graph.py"
click node_topic_graph "https://github.com/neo4j-graphacademy/llm-vectors-unstructured/blob/main/llm-vectors-unstructured/solutions/build_graph_topics.py"
click node_query_example "https://github.com/neo4j-graphacademy/llm-vectors-unstructured/blob/main/llm-vectors-unstructured/solutions/query_neo4j.py"
click node_vector_store "https://github.com/neo4j-graphacademy/llm-vectors-unstructured/blob/main/llm-vectors-unstructured/solutions/create_vector.py"
click node_topic_demo "https://github.com/neo4j-graphacademy/llm-vectors-unstructured/blob/main/llm-vectors-unstructured/solutions/extract_topics.py"
click node_quora_filter "https://github.com/neo4j-graphacademy/llm-vectors-unstructured/blob/main/llm-vectors-unstructured/solutions/quora_filter.py"
click node_quora_embed "https://github.com/neo4j-graphacademy/llm-vectors-unstructured/blob/main/llm-vectors-unstructured/solutions/quora_embeddings.py"
click node_poster_embed "https://github.com/neo4j-graphacademy/llm-vectors-unstructured/blob/main/llm-vectors-unstructured/solutions/poster_embeddings.py"
click node_starter_graph "https://github.com/neo4j-graphacademy/llm-vectors-unstructured/blob/main/llm-vectors-unstructured/build_graph.py"
click node_starter_vector "https://github.com/neo4j-graphacademy/llm-vectors-unstructured/blob/main/llm-vectors-unstructured/create_vector.py"
click node_starter_query "https://github.com/neo4j-graphacademy/llm-vectors-unstructured/blob/main/llm-vectors-unstructured/query_neo4j.py"
click node_starter_embed "https://github.com/neo4j-graphacademy/llm-vectors-unstructured/blob/main/llm-vectors-unstructured/create_embeddings.py"

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_lessons toneBlue
class node_load_chunk,node_course_data,node_embed_text,node_graph_writer,node_topic_graph,node_neo4j,node_starter_graph,node_starter_embed toneAmber
class node_query_example,node_vector_store,node_starter_vector,node_starter_query toneMint
class node_topic_demo,node_quora_filter,node_quora_embed,node_poster_embed toneRose
class node_learner,node_openai toneIndigo
```

## Components

### Course content

- [Lesson corpus](https://github.com/neo4j-graphacademy/llm-vectors-unstructured/tree/main/llm-vectors-unstructured/data/asciidoc): `llm-vectors-unstructured/data/asciidoc`

### Ingestion examples

- [Load and chunk](https://github.com/neo4j-graphacademy/llm-vectors-unstructured/blob/main/llm-vectors-unstructured/solutions/build_graph.py): `llm-vectors-unstructured/solutions/build_graph.py`
- [Course metadata](https://github.com/neo4j-graphacademy/llm-vectors-unstructured/blob/main/llm-vectors-unstructured/solutions/build_graph.py): `llm-vectors-unstructured/solutions/build_graph.py`
- [Text embeddings](https://github.com/neo4j-graphacademy/llm-vectors-unstructured/blob/main/llm-vectors-unstructured/solutions/build_graph.py): `llm-vectors-unstructured/solutions/build_graph.py`
- [Course graph writer](https://github.com/neo4j-graphacademy/llm-vectors-unstructured/blob/main/llm-vectors-unstructured/solutions/build_graph.py): `llm-vectors-unstructured/solutions/build_graph.py`
- [Topic graph writer](https://github.com/neo4j-graphacademy/llm-vectors-unstructured/blob/main/llm-vectors-unstructured/solutions/build_graph_topics.py): `llm-vectors-unstructured/solutions/build_graph_topics.py`
- **Neo4j database**
- [Graph starter](https://github.com/neo4j-graphacademy/llm-vectors-unstructured/blob/main/llm-vectors-unstructured/build_graph.py): `llm-vectors-unstructured/build_graph.py`
- [Embedding starter](https://github.com/neo4j-graphacademy/llm-vectors-unstructured/blob/main/llm-vectors-unstructured/create_embeddings.py): `llm-vectors-unstructured/create_embeddings.py`

### Vector search

- [Vector query example](https://github.com/neo4j-graphacademy/llm-vectors-unstructured/blob/main/llm-vectors-unstructured/solutions/query_neo4j.py): `llm-vectors-unstructured/solutions/query_neo4j.py`
- [Vector store setup](https://github.com/neo4j-graphacademy/llm-vectors-unstructured/blob/main/llm-vectors-unstructured/solutions/create_vector.py): `llm-vectors-unstructured/solutions/create_vector.py`
- [Vector starter](https://github.com/neo4j-graphacademy/llm-vectors-unstructured/blob/main/llm-vectors-unstructured/create_vector.py): `llm-vectors-unstructured/create_vector.py`
- [Query starter](https://github.com/neo4j-graphacademy/llm-vectors-unstructured/blob/main/llm-vectors-unstructured/query_neo4j.py): `llm-vectors-unstructured/query_neo4j.py`

### Additional examples

- [Topic extraction demo](https://github.com/neo4j-graphacademy/llm-vectors-unstructured/blob/main/llm-vectors-unstructured/solutions/extract_topics.py): `llm-vectors-unstructured/solutions/extract_topics.py`
- [Quora filtering](https://github.com/neo4j-graphacademy/llm-vectors-unstructured/blob/main/llm-vectors-unstructured/solutions/quora_filter.py): `llm-vectors-unstructured/solutions/quora_filter.py`
- [Quora embeddings](https://github.com/neo4j-graphacademy/llm-vectors-unstructured/blob/main/llm-vectors-unstructured/solutions/quora_embeddings.py): `llm-vectors-unstructured/solutions/quora_embeddings.py`
- [Poster embeddings](https://github.com/neo4j-graphacademy/llm-vectors-unstructured/blob/main/llm-vectors-unstructured/solutions/poster_embeddings.py): `llm-vectors-unstructured/solutions/poster_embeddings.py`

### Other components

- **Course learner**
- **OpenAI embeddings**

## Connections

- Course learner → Lesson corpus: studies (evidence: `README.adoc`)
- Lesson corpus → Load and chunk: loads and chunks (evidence: `llm-vectors-unstructured/solutions/build_graph.py`)
- Load and chunk → Course metadata: passes chunks (evidence: `llm-vectors-unstructured/solutions/build_graph.py`)
- Course metadata → Text embeddings: requests embeddings (evidence: `llm-vectors-unstructured/solutions/build_graph.py`)
- Text embeddings → OpenAI embeddings: calls embeddings (evidence: `llm-vectors-unstructured/solutions/build_graph.py`)
- Course metadata → Course graph writer: supplies metadata (evidence: `llm-vectors-unstructured/solutions/build_graph.py`)
- Load and chunk → Course graph writer: dispatches writes (evidence: `llm-vectors-unstructured/solutions/build_graph.py`)
- Course graph writer → Neo4j database: writes graph (evidence: `llm-vectors-unstructured/solutions/build_graph.py`)
- Topic graph writer → Neo4j database: writes topics (evidence: `llm-vectors-unstructured/solutions/build_graph_topics.py`)
- Topic graph writer → OpenAI embeddings: requests embeddings (evidence: `llm-vectors-unstructured/solutions/build_graph_topics.py`)
- Vector query example → OpenAI embeddings: embeds question (evidence: `llm-vectors-unstructured/solutions/query_neo4j.py`)
- Vector query example → Neo4j database: queries index (evidence: `llm-vectors-unstructured/solutions/query_neo4j.py`)
- Vector store setup → Neo4j database: configures store
- Quora embeddings → OpenAI embeddings: requests embeddings (evidence: `llm-vectors-unstructured/solutions/quora_embeddings.py`)
- Poster embeddings → Neo4j database: reads movie posters (evidence: `llm-vectors-unstructured/solutions/poster_embeddings.py`)
- Poster embeddings → OpenAI embeddings: uses image model
- Graph starter → Neo4j database: planned graph write
- Query starter → Neo4j database: planned query
