Establish clean homelab infrastructure baseline

Reorganize the brownfield repository, remove retired and generated artifacts, harden ignore rules, and record the GitOps/IaC redesign.

apps/openviking/.env.example

@@ -0,0 +1,7 @@
+# OpenViking container ports
+OPENVIKING_HTTP_PORT=1933
+OPENVIKING_UI_PORT=8020
+JINA_HTTP_PORT=8081
+
+# Optional: disable the bundled VikingBot UI/agent helper if you do not need it.
+OPENVIKING_WITH_BOT=1

apps/openviking/README.md

@@ -0,0 +1,65 @@
+# OpenViking (Docker)
+
+This folder contains a Docker Compose setup for OpenViking using the official image.
+
+## What this setup assumes
+
+- VLM provider: `openai-codex`
+- Embedding model family: `jina-embeddings-v5-text-small-clustering`
+- Embedding server: local OpenAI-compatible endpoint powered by `llama.cpp` CUDA12 image
+- Persistent OpenViking data lives in `./data`
+- Persistent embedding model cache lives in `./models` (mounted to Hugging Face cache)
+- HTTP API is exposed on `1933`
+- Console/UI is exposed on `8020`
+- Local embedding endpoint is exposed on `127.0.0.1:8081`
+
+## Files
+
+- `docker-compose.yml` — the container definition
+- `.env.example` — optional port/bot defaults
+- `ov.conf.example` — configuration example using local Jina embeddings + Codex VLM
+- `ovcli.conf.example` — CLI/client config example
+
+## Setup
+
+1. Copy the env template:
+
+```bash
+cp .env.example .env
+```
+
+2. Create the persistent directories and copy the config examples:
+
+```bash
+mkdir -p data models
+cp ov.conf.example data/ov.conf
+cp ovcli.conf.example data/ovcli.conf
+mkdir -p data/workspace
+```
+
+3. Start the containers:
+
+```bash
+docker compose up -d
+```
+
+4. If Codex auth is not yet available, complete the login/import step inside the OpenViking container:
+
+```bash
+docker compose exec -it openviking openviking-server init
+```
+
+5. Verify the server:
+
+```bash
+docker compose exec -it openviking openviking-server doctor
+curl http://localhost:1933/health
+```
+
+## Notes
+
+- The embedding service uses the Jina v5 omni small text-matching GGUF model and serves an OpenAI-compatible `/v1` API locally.
+- `provider: "openai"` is used in `ov.conf` because the embedding endpoint is OpenAI-compatible, even though the underlying model is Jina.
+- `provider: "openai-codex"` does not require `vlm.api_key` once Codex OAuth is available through `openviking-server init`.
+- If you want the bundled VikingBot disabled, set `OPENVIKING_WITH_BOT=0` in `.env`.
+- The first startup can take a while because the Jina model must be downloaded into `./models`.

apps/openviking/data/ov.conf

@@ -0,0 +1,26 @@
+{
+  "storage": {
+    "workspace": "/app/.openviking/workspace",
+    "vectordb": {
+      "name": "context",
+      "backend": "local"
+    },
+    "agfs": {
+      "backend": "local"
+    }
+  },
+  "embedding": {
+    "dense": {
+      "api_base": "http://jina-embeddings:8080/v1",
+      "api_key": "local-jina",
+      "provider": "openai",
+      "dimension": 1024,
+      "model": "jinaai/jina-embeddings-v5-omni-small-text-matching-GGUF"
+    }
+  },
+  "vlm": {
+    "api_base": "https://chatgpt.com/backend-api/codex",
+    "provider": "openai-codex",
+    "model": "gpt-5.3-codex"
+  }
+}

apps/openviking/data/ovcli.conf

@@ -0,0 +1,4 @@
+{
+  "url": "http://localhost:1933",
+  "timeout": 60.0
+}

apps/openviking/docker-compose.yml

@@ -0,0 +1,40 @@
+services:
+  jina-embeddings:
+    image: ghcr.io/ggml-org/llama.cpp:server-cuda12-b8914
+    container_name: jina-embeddings
+    deploy:
+      resources:
+        reservations:
+          devices:
+            - driver: nvidia
+              count: 1
+              capabilities: [gpu]
+    ports:
+      - "127.0.0.1:${JINA_HTTP_PORT:-8081}:8080"
+    volumes:
+      - ./models:/root/.cache/huggingface
+    command:
+      - -hf
+      - jinaai/jina-embeddings-v5-omni-small-clustering-GGUF:Q2_M
+      - --embedding
+      - --host
+      - "0.0.0.0"
+      - --port
+      - "8080"
+    restart: unless-stopped
+
+  openviking:
+    image: ghcr.io/volcengine/openviking:latest
+    container_name: openviking
+    depends_on:
+      - jina-embeddings
+    ports:
+      - "${OPENVIKING_HTTP_PORT:-1933}:1933"
+      - "${OPENVIKING_UI_PORT:-8020}:8020"
+    volumes:
+      - ./data:/app/.openviking
+    environment:
+      - OPENVIKING_CONFIG_FILE=/app/.openviking/ov.conf
+      - OPENVIKING_CLI_CONFIG_FILE=/app/.openviking/ovcli.conf
+      - OPENVIKING_WITH_BOT=${OPENVIKING_WITH_BOT:-1}
+    restart: unless-stopped

apps/openviking/ov.conf.example

@@ -0,0 +1,26 @@
+{
+  "storage": {
+    "workspace": "/app/.openviking/workspace",
+    "vectordb": {
+      "name": "context",
+      "backend": "local"
+    },
+    "agfs": {
+      "backend": "local"
+    }
+  },
+  "embedding": {
+    "dense": {
+      "api_base": "http://jina-embeddings:8080/v1",
+      "api_key": "local-jina",
+      "provider": "openai",
+      "dimension": 1024,
+      "model": "jinaai/jina-embeddings-v5-omni-small-text-matching-GGUF"
+    }
+  },
+  "vlm": {
+    "api_base": "https://chatgpt.com/backend-api/codex",
+    "provider": "openai-codex",
+    "model": "gpt-5.3-codex"
+  }
+}

apps/openviking/ovcli.conf.example

@@ -0,0 +1,4 @@
+{
+  "url": "http://localhost:1933",
+  "timeout": 60.0
+}