don't mention poetry in doc

Author: nilo19

src/aks-agent/.gitignore

@@ -0,0 +1,3 @@
+# Ignore Poetry artifacts
+poetry.lock
+pyproject.toml

src/aks-agent/azext_aks_agent/tests/evals/README.md

@@ -1,5 +1,22 @@
 # AKS Agent Evals
 
+## Environment Setup
+
+Create and activate a virtual environment (example shown for bash-compatible shells):
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+python -m pip install --upgrade pip
+python -m pip install -e .
+```
+
+Optional tooling used by the eval harness (Braintrust uploads and semantic classifier helpers):
+
+```bash
+python -m pip install braintrust openai autoevals
+```
+
 ## Running Live Scenarios
 
 ```bash
@@ -12,7 +29,7 @@ KUBECONFIG=<path-to-kubeconfig> \
 AZURE_API_KEY=<key> \
 AZURE_API_BASE=<endpoint> \
 AZURE_API_VERSION=<version> \
-poetry run pytest azext_aks_agent/tests/evals/test_ask_agent.py -k 01_list_all_nodes -m aks_eval
+python -m pytest azext_aks_agent/tests/evals/test_ask_agent.py -k 01_list_all_nodes -m aks_eval
 ```
 
 Per-scenario overrides (`resource_group`, `cluster_name`, `kubeconfig`, `test_env_vars`) still apply. Use `--skip-setup` or `--skip-cleanup` to bypass hooks. Expect the test to log iteration progress, classifier scores, and (on the final iteration) a Braintrust link when uploads are enabled.
@@ -43,10 +60,10 @@ KUBECONFIG=<path-to-kubeconfig> \
 AZURE_API_KEY=<key> \
 AZURE_API_BASE=<endpoint> \
 AZURE_API_VERSION=<version> \
-poetry run pytest azext_aks_agent/tests/evals/test_ask_agent.py -k 02_list_clusters -m aks_eval
+python -m pytest azext_aks_agent/tests/evals/test_ask_agent.py -k 02_list_clusters -m aks_eval
 
 # Re-run offline using the recorded response
-poetry run pytest azext_aks_agent/tests/evals/test_ask_agent.py -k 02_list_clusters -m aks_eval
+python -m pytest azext_aks_agent/tests/evals/test_ask_agent.py -k 02_list_clusters -m aks_eval
 ```
 
 If a mock is missing, pytest skips the scenario with instructions to regenerate it.
@@ -72,18 +89,6 @@ Set the following environment variables to push results:
 - `BRAINTRUST_API_KEY` and `BRAINTRUST_ORG` (required)
 - Optional overrides: `BRAINTRUST_PROJECT` (default `aks-agent`), `BRAINTRUST_DATASET` (default `aks-agent/ask`), `EXPERIMENT_ID`
 
-Install the Braintrust client once networking is available:
-
-```bash
-poetry add braintrust --group dev
-```
-
-For a one-shot setup that installs all dev dependencies (Braintrust, openai, autoevals, pytest plugins), run:
-
-```bash
-poetry install --with dev
-```
-
 Each iteration logs to Braintrust; the console prints a clickable link (for aware terminals) when uploads succeed.
 
 **Tips**
@@ -96,11 +101,7 @@ Each iteration logs to Braintrust; the console prints a clickable link (for awar
 
 - Enabled by default; set `ENABLE_CLASSIFIER=false` to opt out.
 - Requires Azure OpenAI credentials: `AZURE_API_BASE`, `AZURE_API_KEY`, `AZURE_API_VERSION`, and a classifier deployment specified via `CLASSIFIER_MODEL` (e.g. `azure/<deployment>`). Defaults to the same deployment as `MODEL` when not provided.
-- Install classifier dependencies when online:
-
-  ```bash
-  poetry add openai autoevals --group dev
-  ```
+- Install classifier dependencies when online (see Environment Setup above if not already installed).
 
 - Scenarios can override the grading style by adding:
 
@@ -115,7 +116,7 @@ Classifier scores and rationales are attached to Braintrust uploads and printed
 **Debugging classifiers**
 
 ```
-poetry run pytest ... -o log_cli=true -o log_cli_level=DEBUG -s
+python -m pytest ... -o log_cli=true -o log_cli_level=DEBUG -s
 ```
 
 Look for `classifier score ...` lines to confirm the semantic judge executed.
@@ -134,7 +135,7 @@ Look for `classifier score ...` lines to confirm the semantic judge executed.
 
 ## Quick Checklist
 
-- `poetry install --with dev` to ensure Braintrust + classifier dependencies are present.
+- Install dependencies inside a virtual environment (`python -m pip install -e .`) and, if needed, the optional tooling (`python -m pip install braintrust openai autoevals`).
 - `RUN_LIVE=true`: set Azure creds (`AZURE_API_KEY`, `AZURE_API_BASE`, `AZURE_API_VERSION`), `MODEL`, kubeconfig, and optional Braintrust vars.
 - `RUN_LIVE` unset/false: ensure each scenario directory has `mocks/response.txt`.
 - Classifier overrides: `CLASSIFIER_MODEL` (defaults to `MODEL`) and per-scenario `evaluation.correctness.type`.