update the init file to load variables form .env then check if they are populated.

change README.md file change the run server path add template.env

Author: MRGuziX

agents/base/langgraph_react_agent/README.md

@@ -1,28 +1,40 @@
 <div style="text-align: center;">
 
 ![LangGraph Logo](/images/langgraph_logo.svg)
+
 # ReACT Agent
 
 </div>
 
 ---
+
 ## What this agent does
-General-purpose agent using a ReAct loop: it reasons and calls tools (e.g. search, math) step by step. Built with LangGraph and LangChain.
+
+General-purpose agent using a ReAct loop: it reasons and calls tools (e.g. search, math) step by step. Built with
+LangGraph and LangChain.
 
 ---
+
 ### Preconditions:
-- You need to copy/paste .env file and change its values to yours
+
+- You need to change .env.template file to .env
 - Decide what way you want to go `local` or `RH OpenShift Cluster` and fill needed values
 - use `./init.sh` that will add those values from .env to environment variables
 
+Go to agent dir
 
+```bash
+cd agents/base/langgraph_react_agent
+```
 
 Copy .env file
+
 ```bash
-cp template.env agents/base/langgraph_react_agent/.env
+mv template.env .env
 ```
 
 #### Local
+
 Edit the `.env` file with your local configuration:
 
 ```
@@ -33,6 +45,7 @@ CONTAINER_IMAGE=not-needed
 ```
 
 #### OpenShift Cluster
+
 Edit the `.env` file and fill in all required values:
 
 ```
@@ -43,46 +56,47 @@ CONTAINER_IMAGE=quay.io/your-username/langgraph-react-agent:latest
 ```
 
 **Notes:**
+
 - `API_KEY` - contact your cluster administrator
 - `BASE_URL` - should end with `/v1`
 - `MODEL_ID` - contact your cluster administrator
 - `CONTAINER_IMAGE` - full image path where the agent container will be pushed and pulled from.
   The image is built locally, pushed to this registry, and then deployed to OpenShift.
 
   Format: `<registry>/<namespace>/<image-name>:<tag>`
-  
-  Examples:
-  - Quay.io: `quay.io/your-username/langgraph-react-agent:latest`
-  - Docker Hub: `docker.io/your-username/langgraph-react-agent:latest`
-  - GHCR: `ghcr.io/your-org/langgraph-react-agent:latest`
 
-Go to agent dir
-```bash
-cd agents/base/langgraph_react_agent
-```
+  Examples:
+    - Quay.io: `quay.io/your-username/langgraph-react-agent:latest`
+    - Docker Hub: `docker.io/your-username/langgraph-react-agent:latest`
+    - GHCR: `ghcr.io/your-org/langgraph-react-agent:latest`
 
 Create and activate a virtual environment (Python 3.12) in this directory using [uv](https://docs.astral.sh/uv/):
+
 ```bash
 uv venv --python 3.12
 source .venv/bin/activate
 ```
+
 (On Windows: `.venv\Scripts\activate`)
 
 Make scripts executable
+
 ```bash
 chmod +x init.sh
 ```
 
 Add to values from .env to environment variables
+
 ```bash
-./init.sh
+source ./init.sh
 ```
 
 ---
 
 ## Local usage (Ollama + LlamaStack Server)
 
 Create package with agent and install it to venv
+
 ```bash
 uv pip install -e .
 ```
@@ -92,75 +106,93 @@ uv pip install ollama
 ```
 
 Install app from Ollama site or via Brew
+
 ```bash
 #brew install ollama
 # or
 curl -fsSL https://ollama.com/install.sh | sh
 ```
 
 Pull Required Model
+
 ```bash
 ollama pull llama3.2:3b
 ```
 
 Start Ollama Service
+
 ```bash
 ollama serve
 ```
->**Keep this terminal open!**\
+
+> **Keep this terminal open!**\
 > Ollama needs to keep running.
 
 Start LlamaStack Server
+
 ```bash
 llama stack run ../../../run_llama_server.yaml
 ```
+
 > **Keep this terminal open** - the server needs to keep running.\
 > You should see output indicating the server started on `http://localhost:8321`.
 
- Run the example:
+Run the example:
+
 ```bash
 uv run examples/execute_ai_service_locally.py
 ```
 
 # Deployment on RedHat OpenShift Cluster
+
 Login to OC
+
 ```bash
 oc login -u "login" -p "password" https://super-link-to-cluster:111
 ```
-Login ex. Docker 
+
+Login ex. Docker
+
 ```bash
 docker login -u='login' -p='password' quay.io
 ```
 
 Make deploy file executable
+
 ```bash
 chmod +x deploy.sh
 ```
 
 Build image and deploy Agent
+
 ```bash
 ./deploy.sh
 ```
 
 This will:
+
 - Create Kubernetes secret for API key
 - Build and push the Docker image
 - Deploy the agent to OpenShift
 - Create Service and Route
 
 COPY the route URL and PASTE into the CURL below
+
 ```bash
 oc get route langgraph-react-agent -o jsonpath='{.spec.host}'
 ```
 
 Send a test request:
+
 ```bash
 curl -X POST https://<YOUR_ROUTE_URL>/chat \
   -H "Content-Type: application/json" \
   -d '{"message": "What is the best company? Answer with the first correct answer."}'
 ```
 
 ## Agent-Specific Documentation
+
 Each agent has detailed documentation for setup and deployment:
+
 - https://ollama.com/
 - https://formulae.brew.sh/formula/ollama#default

agents/base/langgraph_react_agent/init.sh

@@ -1,27 +1,64 @@
 #!/bin/bash
-# Usage:
-#   ./init.sh
+#
+# init.sh - Environment bootstrap for the LangGraph ReAct Agent
+#
+# Loads environment variables from the .env file located next to this script,
+# validates that all required variables (API_KEY, BASE_URL, MODEL_ID,
+# CONTAINER_IMAGE) are set, and ensures the shared milvus_data directory
+# exists at the repository root.
 
-set -e
+#
+# Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
+#
 
-source .env && echo "Environment variables loading from .env file"
+# Resolve the directory containing this script (works when sourced or executed)
+# BASH_SOURCE works in bash; ${(%):-%x} is the zsh equivalent
+AGENT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]:-${(%):-%x}}")" && pwd)"
+REPO_ROOT="$AGENT_DIR/../../.."
+ENV_FILE="$AGENT_DIR/.env"
 
-if [ -z "$API_KEY" ]; then
-    echo "API_KEY not set, check .env file"
-    exit 1
-fi
+# 1. Load .env, export variables, and collect their names for validation
+ENV_VARS=()
 
-if [ -z "$BASE_URL" ]; then
-    echo "BASE_URL not set, check .env file"
-    exit 1
+if [ -f "$ENV_FILE" ]; then
+    while IFS= read -r line || [ -n "$line" ]; do
+        line="${line//$'\r'/}"
+        line="${line#"${line%%[![:space:]]*}"}"
+        [[ -z "$line" || "$line" == \#* ]] && continue
+        export "$line"
+        ENV_VARS+=("${line%%=*}")
+    done < "$ENV_FILE"
+    echo "Environment variables loaded from $ENV_FILE"
+else
+    echo "ERROR: .env file not found at $ENV_FILE"
+    return 1 2>/dev/null || exit 1
 fi
 
-if [ -z "$MODEL_ID" ]; then
-    echo "MODEL_ID not set, check .env file"
-    exit 1
-fi
+# 2. Validate every variable found in .env
+for var_name in "${ENV_VARS[@]}"; do
+    var_value=$(eval echo "\$$var_name")
+    if [ -z "$var_value" ]; then
+        echo "  ERROR: $var_name is empty. Check your .env file."
+        return 1 2>/dev/null || exit 1
+    fi
+    local_lower=$(echo "$var_name" | tr '[:upper:]' '[:lower:]')
+    if [[ "$local_lower" == *password* || "$local_lower" == *apikey* || "$local_lower" == *api_key* || "$local_lower" == *secret* || "$local_lower" == *token* ]]; then
+        echo "  $var_name=****"
+    else
+        echo "  $var_name=$var_value"
+    fi
+done
 
-if [ -z "$CONTAINER_IMAGE" ]; then
-    echo "CONTAINER_IMAGE not set, check .env file"
-    exit 1
-fi
+# 3. Ensure milvus_data directory exists at repo root
+MILVUS_DIR="$REPO_ROOT/milvus_data"
+
+if [ -d "$MILVUS_DIR" ]; then
+    echo "milvus_data directory exists in root folder"
+else
+    if mkdir -p "$MILVUS_DIR"; then
+        echo "Created milvus_data directory at: $MILVUS_DIR"
+    else
+        echo "ERROR: Failed to create $MILVUS_DIR"
+        return 1 2>/dev/null || exit 1
+    fi
+fi

agents/base/langgraph_react_agent/template.env

@@ -0,0 +1,4 @@
+# API_KEY=
+# BASE_URL=
+# MODEL_ID=
+# CONTAINER_IMAGE=