History

juvdiaz 3c24b7fbc4 Add AI knowledge exclude list		2026-06-29 21:05:30 -06:00
..
README.md	Add optional homelab AI knowledge index	2026-06-27 23:14:27 -06:00
knowledge-excludes.txt	Add AI knowledge exclude list	2026-06-29 21:05:30 -06:00
knowledge-sources.txt	Add optional homelab AI knowledge index	2026-06-27 23:14:27 -06:00

README.md

Homelab AI Knowledge Index

This directory defines the optional local knowledge layer for the backstage jeannie helper.

The index is not model training. It is retrieval over repo files, so current inventory, runbooks, scripts, Terraform, compose files, and app manifests remain normal source-controlled text.

Build

Run on the Debian homelab server:

./jeannie ai-index

The default index path comes from homelab.yml:

/data/homelab-ai/index

Override it with LAB_AI_KNOWLEDGE_INDEX_DIR when testing.

Check

./jeannie ai-check

This validates:

Python is available
the index exists
a simple retrieval query returns context
Ollama is reachable when the backstage helper is enabled
the configured model is pulled

Query

The query script can be used directly:

scripts/query-homelab-ai-index "gitea public url is failing"
scripts/query-homelab-ai-index --ask "why is lab2025 returning 502?"

--ask sends retrieved context to the configured Ollama endpoint and model.