Made readme files

stacks/ai/ai-frontend/README.md

@@ -0,0 +1,61 @@
+# AI Frontend Nomad Job
+
+This Nomad job defines the deployment for two AI frontend applications: Open WebUI and LobeChat. Both frontends are designed to interact with an Ollama backend (like the one defined in `ai-backend.nomad`).
+
+## What is this file?
+
+The [`ai-frontend.nomad`](stacks/ai/ai-frontend.nomad) file is a HashiCorp Nomad job specification written in HCL. It describes how to deploy and manage the Open WebUI and LobeChat services.
+
+Key configurations:
+
+### Open WebUI Group
+-   **`group "openwebui"`**: Defines the task group for Open WebUI.
+-   **`constraint { attribute = "${attr.unique.hostname}"; value = "hp1-home" }`**: Ensures Open WebUI runs on the `hp1-home` node.
+-   **`network { port "http" { static = 8080; to = 8080 } }`**: Exposes port 8080 for Open WebUI.
+-   **`service "openwebui"`**: Registers the service with Consul and Traefik.
+    -   `tags = ["traefik.enable=true"]`: Enables Traefik ingress.
+-   **`task "server"`**: The Open WebUI container.
+    -   **`driver = "podman"`**: Uses Podman.
+    -   **`env { OLLAMA_BASE_URL = "http://ollama:11434" }`**: Configures Open WebUI to connect to the Ollama service.
+    -   **`config { image = "ghcr.io/open-webui/open-webui:main" }`**: Uses the official Open WebUI image.
+    -   **`volumes = ["/mnt/local-ssd/nomad/stacks/ai/ai-frontend/openwebui:/app/backend/data"]`**: Persistent storage for Open WebUI data.
+
+### LobeChat Group
+-   **`group "lobechat"`**: Defines the task group for LobeChat.
+-   **`constraint { attribute = "${attr.unique.hostname}"; value = "hp1-home" }`**: Ensures LobeChat runs on the `hp1-home` node.
+-   **`network { port "http" { static = 3210; to = 3210 } }`**: Exposes port 3210 for LobeChat.
+-   **`service "lobechat"`**: Registers the service with Consul.
+    -   *No Traefik tags*: This service is not exposed via Traefik by default.
+-   **`task "server"`**: The LobeChat container.
+    -   **`driver = "podman"`**: Uses Podman.
+    -   **`env { OLLAMA_PROXY_URL = "http://ollama.service.consul:11434" }`**: Configures LobeChat to connect to the Ollama service via Consul DNS.
+    -   **`config { image = "lobehub/lobe-chat:latest" }`**: Uses the official LobeChat image.
+    -   **`volumes = ["/mnt/local-ssd/nomad/stacks/ai/ai-frontend/lobechat/data:/data"]`**: Persistent storage for LobeChat data.
+
+## How to use it
+
+To deploy these AI frontend applications:
+
+1.  Ensure you have a Nomad cluster running with a client node tagged `hp1-home` that has Podman installed.
+2.  Make sure the following directories exist on the host for persistent data:
+    -   `/mnt/local-ssd/nomad/stacks/ai/ai-frontend/openwebui`
+    -   `/mnt/local-ssd/nomad/stacks/ai/ai-frontend/lobechat/data`
+3.  Ensure your Ollama backend is deployed and accessible (e.g., via the `ai-backend.nomad` job).
+4.  Execute the following command on your Nomad server (or a machine with Nomad CLI access configured to connect to your server):
+
+    ```bash
+    nomad job run stacks/ai/ai-frontend.nomad
+    ```
+
+After deployment:
+-   Open WebUI will be accessible on port 8080 on the host machine, and via Traefik if properly configured.
+-   LobeChat will be accessible on port 3210 on the host machine. If you wish to expose LobeChat externally, you will need to add appropriate Traefik tags to its `service` block.
+
+## Projects Involved
+
+-   **[HashiCorp Nomad](https://www.nomadproject.io/)**: A workload orchestrator.
+-   **[Open WebUI](https://docs.openwebui.com/)**: A user-friendly, open-source web interface for LLMs.
+-   **[LobeChat](https://github.com/lobehub/lobe-chat)**: An open-source, high-performance, extensible LLM chatbot framework.
+-   **[Podman](https://podman.io/)**: A daemonless container engine.
+-   **[Traefik](https://traefik.io/traefik/)**: An open-source Edge Router (used by Open WebUI).
+-   **[HashiCorp Consul](https://www.consul.io/)**: A service mesh solution providing service discovery, configuration, and segmentation (used for internal service discovery for Ollama by LobeChat).