Merge pull request #12 from red-hat-data-services/dev-update-readmes

docs: update READMEs with proper venv

Author: Wojciech-Rebisz

README.md

@@ -72,11 +72,6 @@ Install UV
 ```bash
 curl -LsSf https://astral.sh/uv/install.sh | sh
 ```
-Create venv and activate
-```bash
-uv venv --python 3.12
-source .venv/bin/activate
-```
 ---
 
 ## Next Steps

agents/base/langgraph_react_agent/README.md

@@ -57,6 +57,13 @@ Go to agent dir
 cd agents/base/langgraph_react_agent
 ```
 
+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
@@ -108,7 +115,7 @@ llama stack run ../../../run_llama_server.yaml
 
  Run the example:
 ```bash
-uv run agents/base/langgraph_react_agent/examples/execute_ai_service_locally.py
+uv run examples/execute_ai_service_locally.py
 ```
 
 # Deployment on RedHat OpenShift Cluster

agents/base/llamaindex_websearch_agent/README.md

@@ -57,6 +57,13 @@ Go to agent dir
 cd agents/base/llamaindex_websearch_agent
 ```
 
+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

agents/base/openai_responses_agent/README.md

@@ -4,6 +4,7 @@
 
 </div>
 
+---
 Agent **without any agentic framework**: uses only the **OpenAI Python client** and **pure Python** (Responses API). No LlamaStack, LangChain, LlamaIndex, etc. Uses `AIAgent` with chat, tools, and Action/Observation loop. Compatible with OpenAI API or any OpenAI-compatible endpoint (e.g. `BASE_URL` override). Python 3.12+.
 
 ---
@@ -74,6 +75,15 @@ Go to agent dir:
 cd agents/base/openai_responses_agent
 ```
 
+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
@@ -133,7 +143,7 @@ llama stack run ../../../run_llama_server.yaml
 Run the example:
 
 ```bash
-uv run agents/base/openai_responses_agent/examples/execute_ai_service_locally.py
+uv run examples/execute_ai_service_locally.py
 ```
 
 ---

agents/community/langgraph_agentic_rag/README.md

@@ -7,7 +7,6 @@
 </div>
 
 ---
-
 ### Preconditions:
 
 - You need to copy/paste .env file and change its values to yours
@@ -83,6 +82,15 @@ Go to agent dir
 cd agents/community/langgraph_agentic_rag
 ```
 
+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
@@ -160,8 +168,7 @@ This will:
 ### Run the example:
 
 ```bash
-cd ..
-uv run agents/community/langgraph_agentic_rag/examples/execute_ai_service_locally.py
+uv run examples/execute_ai_service_locally.py
 ```
 
 # Deployment on RedHat OpenShift Cluster