# cs-edwards/demo-multimodal-text-to-image-search-py architecture

> Architecture diagram of the GitHub repository cs-edwards/demo-multimodal-text-to-image-search-py, 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/cs-edwards/demo-multimodal-text-to-image-search-py
- Repository: https://github.com/cs-edwards/demo-multimodal-text-to-image-search-py

## Overview

This is a CLIP-powered image search demo: users submit natural-language descriptions through a Flask page, which queries Weaviate and renders matching image records. A separate Go importer creates the image-vector schema and loads image files. The README also describes image-based search and support for additional image formats, though the sampled Python search path only shows text queries. Relationships involving those broader capabilities are therefore documented but not traced to unsampled implementation details.

Main entry points: [`python/app.py`](https://github.com/cs-edwards/demo-multimodal-text-to-image-search-py/blob/main/python/app.py) (Search route), [`import/go/data/objects.go`](https://github.com/cs-edwards/demo-multimodal-text-to-image-search-py/blob/main/import/go/data/objects.go) (Image loader), [`import/go/cmd/main.go`](https://github.com/cs-edwards/demo-multimodal-text-to-image-search-py/blob/main/import/go/cmd/main.go) (Import entry point), [`python/templates/search_page.html`](https://github.com/cs-edwards/demo-multimodal-text-to-image-search-py/blob/main/python/templates/search_page.html) (Search page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_search["Search experience"]
  node_flask["Search route<br/>[app.py]"]
  node_page["Search page<br/>[search_page.html]"]
  node_browser["Show-more control<br/>[script.js]"]
end

subgraph group_storage["Vector search"]
  node_query["Query client<br/>[utils.py]"]
  node_weaviate[("Weaviate")]
  node_clip{{"CLIP vectorizer"}}
end

subgraph group_ingest["Image ingestion"]
  node_importer["Import entry point<br/>[main.go]"]
  node_schema["Image schema<br/>[schema.go]"]
  node_objects["Image loader<br/>[objects.go]"]
  node_images["Image files"]
end

node_user(("Search user"))

node_user -->|"submits query"| node_flask
node_flask -->|"calls search"| node_query
node_flask -->|"renders results"| node_page
node_page -.->|"uses control"| node_browser
node_query -->|"queries records"| node_weaviate
node_weaviate -->|"vectorizes images"| node_clip
node_importer -->|"creates class"| node_schema
node_importer -->|"imports objects"| node_objects
node_objects -->|"reads files"| node_images
node_schema -->|"creates schema"| node_weaviate
node_objects -->|"batches objects"| node_weaviate

click node_flask "https://github.com/cs-edwards/demo-multimodal-text-to-image-search-py/blob/main/python/app.py"
click node_page "https://github.com/cs-edwards/demo-multimodal-text-to-image-search-py/blob/main/python/templates/search_page.html"
click node_browser "https://github.com/cs-edwards/demo-multimodal-text-to-image-search-py/blob/main/python/static/script.js"
click node_query "https://github.com/cs-edwards/demo-multimodal-text-to-image-search-py/blob/main/python/utils.py"
click node_importer "https://github.com/cs-edwards/demo-multimodal-text-to-image-search-py/blob/main/import/go/cmd/main.go"
click node_schema "https://github.com/cs-edwards/demo-multimodal-text-to-image-search-py/blob/main/import/go/data/schema.go"
click node_objects "https://github.com/cs-edwards/demo-multimodal-text-to-image-search-py/blob/main/import/go/data/objects.go"
click node_images "https://github.com/cs-edwards/demo-multimodal-text-to-image-search-py/tree/main/images"

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_flask,node_page,node_browser,node_user toneBlue
class node_query,node_weaviate,node_clip toneAmber
class node_importer,node_schema,node_objects,node_images toneMint
```

## Components

### Search experience

- [Search route](https://github.com/cs-edwards/demo-multimodal-text-to-image-search-py/blob/main/python/app.py): `python/app.py`
- [Search page](https://github.com/cs-edwards/demo-multimodal-text-to-image-search-py/blob/main/python/templates/search_page.html): `python/templates/search_page.html`
- [Show-more control](https://github.com/cs-edwards/demo-multimodal-text-to-image-search-py/blob/main/python/static/script.js): `python/static/script.js`

### Vector search

- [Query client](https://github.com/cs-edwards/demo-multimodal-text-to-image-search-py/blob/main/python/utils.py): `python/utils.py`
- **Weaviate**
- **CLIP vectorizer**

### Image ingestion

- [Import entry point](https://github.com/cs-edwards/demo-multimodal-text-to-image-search-py/blob/main/import/go/cmd/main.go): `import/go/cmd/main.go`
- [Image schema](https://github.com/cs-edwards/demo-multimodal-text-to-image-search-py/blob/main/import/go/data/schema.go): `import/go/data/schema.go`
- [Image loader](https://github.com/cs-edwards/demo-multimodal-text-to-image-search-py/blob/main/import/go/data/objects.go): `import/go/data/objects.go`
- [Image files](https://github.com/cs-edwards/demo-multimodal-text-to-image-search-py/tree/main/images): `images`

### Other components

- **Search user**

## Connections

- Search user → Search route: submits query (evidence: `README.md`)
- Search route → Query client: calls search (evidence: `python/app.py`)
- Search route → Search page: renders results (evidence: `python/app.py`)
- Search page → Show-more control: uses control
- Query client → Weaviate: queries records (evidence: `python/utils.py`)
- Weaviate → CLIP vectorizer: vectorizes images
- Import entry point → Image schema: creates class (evidence: `import/go/cmd/main.go`)
- Import entry point → Image loader: imports objects (evidence: `import/go/cmd/main.go`)
- Image loader → Image files: reads files (evidence: `import/go/data/objects.go`)
- Image schema → Weaviate: creates schema (evidence: `import/go/data/schema.go`)
- Image loader → Weaviate: batches objects (evidence: `import/go/data/objects.go`)
