all agents updated

Author: MRGuziX

agents/crewai/websearch_agent/Dockerfile

@@ -19,8 +19,10 @@ COPY src/ ./src/
 # Install the project and its dependencies using uv
 RUN uv pip install --system --no-cache .
 
-# Copy the application entrypoint
+# Copy the application entrypoint, playground UI, and images
 COPY main.py .
+COPY playground/ ./playground/
+COPY images/ ./images/
 
 # Pre-create the directory that CrewAI writes to at import time
 # (crewai.utilities.paths.db_storage_path -> ~/.local/share/app/)

agents/crewai/websearch_agent/README.md

@@ -203,17 +203,29 @@ curl -sN -X POST https://<YOUR_ROUTE_URL>/chat/completions \
 
 ## Playground UI
 
-A browser-based chat interface for interacting with the agent. Built with Flask, it provides a simple chat window with streaming responses — no curl needed.
+A browser-based chat interface is served directly by the agent at the root URL — no separate process needed.
 
-### Prerequisites
+### Running the Playground
 
-Make sure the agent is running first (see sections above), then install the playground dependency:
+Start the agent and open the root URL in your browser:
 
 ```bash
-uv pip install flask
+uvicorn main:app --port 8000
 ```
 
-### Running the Playground
+Open [http://localhost:8000](http://localhost:8000) in your browser.
+
+A green dot in the header means the agent is connected and ready. Type a message and press **Enter** to send.
+
+When deployed to OpenShift, the playground is available at the route URL.
+
+### Standalone Flask Playground (alternative)
+
+You can also run the playground as a separate Flask app if needed:
+
+```bash
+uv pip install flask
+```
 
 ```bash
 # Terminal 1: Start the agent
@@ -223,12 +235,6 @@ uvicorn main:app --port 8000
 flask --app playground/app run --port 5001
 ```
 
-Open [http://localhost:5001](http://localhost:5001) in your browser.
-
-A green dot in the header means the agent is connected and ready. Type a message and press **Enter** to send.
-
-### Configuration
-
 | Variable    | Default                  | Description                     |
 |-------------|--------------------------|---------------------------------|
 | `AGENT_URL` | `http://localhost:8000`  | URL of the running agent API    |

agents/crewai/websearch_agent/deploy.sh

@@ -16,6 +16,13 @@ set -e  # Exit on error
 source .env
 export CONTAINER_IMAGE BASE_URL MODEL_ID
 
+## ============================================
+# COPY SHARED IMAGES FOR DOCKER BUILD CONTEXT
+## ============================================
+
+cp -r ../../../images ./images && echo "Images copied into build context"
+trap 'rm -rf ./images' EXIT
+
 ## ============================================
 # DOCKER BUILD
 ## ============================================

agents/crewai/websearch_agent/main.py

@@ -6,10 +6,11 @@
 import uuid
 from contextlib import asynccontextmanager
 from os import getenv
+from pathlib import Path
 
 from crewai import LLM
 from fastapi import FastAPI, HTTPException
-from fastapi.responses import StreamingResponse
+from fastapi.responses import FileResponse, HTMLResponse, StreamingResponse
 from pydantic import BaseModel, Field
 
 from crewai_web_search.crew import AssistanceAgents
@@ -364,6 +365,30 @@ async def health():
     return {"status": "healthy", "agent_initialized": llm is not None}
 
 
+# ── Playground UI ────────────────────────────────────────────────────────────
+_BASE_DIR = Path(__file__).resolve().parent
+_PLAYGROUND_HTML = _BASE_DIR / "playground" / "templates" / "index.html"
+# In Docker the images are copied to /app/images; locally they live at the repo root
+_IMAGES_DIR = _BASE_DIR / "images"
+if not _IMAGES_DIR.is_dir():
+    _IMAGES_DIR = _BASE_DIR.parent.parent.parent / "images"
+
+
+@app.get("/", response_class=HTMLResponse, include_in_schema=False)
+async def playground():
+    """Serve the playground chat UI."""
+    return FileResponse(_PLAYGROUND_HTML)
+
+
+@app.get("/images/{filename:path}", include_in_schema=False)
+async def serve_image(filename: str):
+    """Serve images from the project-level images directory."""
+    file_path = _IMAGES_DIR / filename
+    if not file_path.is_file():
+        raise HTTPException(status_code=404, detail="Image not found")
+    return FileResponse(file_path)
+
+
 if __name__ == "__main__":
     import uvicorn
 

agents/langgraph/agentic_rag/README.md

@@ -256,17 +256,29 @@ curl -X POST https://<YOUR_ROUTE_URL>/stream \
 
 ## Playground UI
 
-A browser-based chat interface for interacting with the agent. Built with Flask, it provides a simple chat window with streaming responses — no curl needed.
+A browser-based chat interface is served directly by the agent at the root URL — no separate process needed.
 
-### Prerequisites
+### Running the Playground
 
-Make sure the agent is running first (see sections above), then install the playground dependency:
+Start the agent and open the root URL in your browser:
 
 ```bash
-uv pip install flask
+uvicorn main:app --port 8000
 ```
 
-### Running the Playground
+Open [http://localhost:8000](http://localhost:8000) in your browser.
+
+A green dot in the header means the agent is connected and ready. Type a message and press **Enter** to send.
+
+When deployed to OpenShift, the playground is available at the route URL.
+
+### Standalone Flask Playground (alternative)
+
+You can also run the playground as a separate Flask app if needed:
+
+```bash
+uv pip install flask
+```
 
 ```bash
 # Terminal 1: Start the agent
@@ -276,12 +288,6 @@ uvicorn main:app --port 8000
 flask --app playground/app run --port 5001
 ```
 
-Open [http://localhost:5001](http://localhost:5001) in your browser.
-
-A green dot in the header means the agent is connected and ready. Type a message and press **Enter** to send.
-
-### Configuration
-
 | Variable    | Default                  | Description                     |
 |-------------|--------------------------|---------------------------------|
 | `AGENT_URL` | `http://localhost:8000`  | URL of the running agent API    |

agents/langgraph/react_agent/README.md

@@ -213,18 +213,29 @@ curl -X POST https://<YOUR_ROUTE_URL>/chat/completions \
 
 ## Playground UI
 
-A browser-based chat interface for interacting with the agent. Built with Flask, it provides a simple chat window with
-streaming responses — no curl needed.
+A browser-based chat interface is served directly by the agent at the root URL — no separate process needed.
 
-### Prerequisites
+### Running the Playground
 
-Make sure the agent is running first (see sections above), then install the playground dependency:
+Start the agent and open the root URL in your browser:
 
 ```bash
-uv pip install flask
+uvicorn main:app --port 8000
 ```
 
-### Running the Playground
+Open [http://localhost:8000](http://localhost:8000) in your browser.
+
+A green dot in the header means the agent is connected and ready. Type a message and press **Enter** to send.
+
+When deployed to OpenShift, the playground is available at the route URL.
+
+### Standalone Flask Playground (alternative)
+
+You can also run the playground as a separate Flask app if needed:
+
+```bash
+uv pip install flask
+```
 
 ```bash
 # Terminal 1: Start the agent
@@ -234,12 +245,6 @@ uvicorn main:app --port 8000
 flask --app playground/app run --port 5001
 ```
 
-Open [http://localhost:5001](http://localhost:5001) in your browser.
-
-A green dot in the header means the agent is connected and ready. Type a message and press **Enter** to send.
-
-### Configuration
-
 | Variable    | Default                 | Description                  |
 |-------------|-------------------------|------------------------------|
 | `AGENT_URL` | `http://localhost:8000` | URL of the running agent API |

agents/llamaindex/websearch_agent/Dockerfile

@@ -19,8 +19,10 @@ COPY src/ ./src/
 # Install the project and its dependencies using uv
 RUN uv pip install --system --no-cache .
 
-# Copy the application entrypoint
+# Copy the application entrypoint, playground UI, and images
 COPY main.py .
+COPY playground/ ./playground/
+COPY images/ ./images/
 
 # Change ownership of the app directory to the non-privileged user
 RUN chown -R appuser:appuser /app

agents/llamaindex/websearch_agent/README.md

@@ -212,17 +212,29 @@ curl -X POST https://<YOUR_ROUTE_URL>/chat/completions \
 
 ## Playground UI
 
-A browser-based chat interface for interacting with the agent. Built with Flask, it provides a simple chat window with streaming responses — no curl needed.
+A browser-based chat interface is served directly by the agent at the root URL — no separate process needed.
 
-### Prerequisites
+### Running the Playground
 
-Make sure the agent is running first (see sections above), then install the playground dependency:
+Start the agent and open the root URL in your browser:
 
 ```bash
-uv pip install flask
+uvicorn main:app --port 8000
 ```
 
-### Running the Playground
+Open [http://localhost:8000](http://localhost:8000) in your browser.
+
+A green dot in the header means the agent is connected and ready. Type a message and press **Enter** to send.
+
+When deployed to OpenShift, the playground is available at the route URL.
+
+### Standalone Flask Playground (alternative)
+
+You can also run the playground as a separate Flask app if needed:
+
+```bash
+uv pip install flask
+```
 
 ```bash
 # Terminal 1: Start the agent
@@ -232,12 +244,6 @@ uvicorn main:app --port 8000
 flask --app playground/app run --port 5001
 ```
 
-Open [http://localhost:5001](http://localhost:5001) in your browser.
-
-A green dot in the header means the agent is connected and ready. Type a message and press **Enter** to send.
-
-### Configuration
-
 | Variable    | Default                  | Description                     |
 |-------------|--------------------------|---------------------------------|
 | `AGENT_URL` | `http://localhost:8000`  | URL of the running agent API    |

agents/llamaindex/websearch_agent/deploy.sh

@@ -16,6 +16,13 @@ set -e  # Exit on error
 source .env
 export CONTAINER_IMAGE BASE_URL MODEL_ID
 
+## ============================================
+# COPY SHARED IMAGES FOR DOCKER BUILD CONTEXT
+## ============================================
+
+cp -r ../../../images ./images && echo "Images copied into build context"
+trap 'rm -rf ./images' EXIT
+
 ## ============================================
 # DOCKER BUILD
 ## ============================================

agents/llamaindex/websearch_agent/main.py

@@ -4,9 +4,10 @@
 import uuid
 from contextlib import asynccontextmanager
 from os import getenv
+from pathlib import Path
 
 from fastapi import FastAPI, HTTPException
-from fastapi.responses import StreamingResponse
+from fastapi.responses import FileResponse, HTMLResponse, StreamingResponse
 from websearch_agent.agent import get_workflow_closure
 from websearch_agent.workflow import ToolCallEvent, InputEvent
 from pydantic import BaseModel, Field
@@ -450,6 +451,30 @@ async def health():
     return {"status": "healthy", "agent_initialized": get_agent is not None}
 
 
+# ── Playground UI ────────────────────────────────────────────────────────────
+_BASE_DIR = Path(__file__).resolve().parent
+_PLAYGROUND_HTML = _BASE_DIR / "playground" / "templates" / "index.html"
+# In Docker the images are copied to /app/images; locally they live at the repo root
+_IMAGES_DIR = _BASE_DIR / "images"
+if not _IMAGES_DIR.is_dir():
+    _IMAGES_DIR = _BASE_DIR.parent.parent.parent / "images"
+
+
+@app.get("/", response_class=HTMLResponse, include_in_schema=False)
+async def playground():
+    """Serve the playground chat UI."""
+    return FileResponse(_PLAYGROUND_HTML)
+
+
+@app.get("/images/{filename:path}", include_in_schema=False)
+async def serve_image(filename: str):
+    """Serve images from the project-level images directory."""
+    file_path = _IMAGES_DIR / filename
+    if not file_path.is_file():
+        raise HTTPException(status_code=404, detail="Image not found")
+    return FileResponse(file_path)
+
+
 if __name__ == "__main__":
     import uvicorn