Skip to content

100+ AI Agents, Agent Skills and RAG Apps - Free and Open Source.

fix: add Windows agent scripts and document uv/Python 3.12 prereq

Kat Laszlod67e5ad2f24e
diff --git a/generative_ui_agents/ai-knowledge-explorer/README.md b/generative_ui_agents/ai-knowledge-explorer/README.md
index 59dff080..c0b96e60 100644
--- a/generative_ui_agents/ai-knowledge-explorer/README.md
+++ b/generative_ui_agents/ai-knowledge-explorer/README.md
@@ -27,10 +27,16 @@ Click a node to see details. Double-click to expand it — the agent extracts su
| LLM | OpenAI (configurable via env) |
| Protocol | AG-UI (state streaming) |
+## Prerequisites
+
+- Node.js 18+
+- Python 3.12
+- [uv](https://docs.astral.sh/uv/) — the agent's Python dependencies are managed with uv, and `npm install` runs `uv sync` automatically. Install it with `curl -LsSf https://astral.sh/uv/install.sh | sh` (macOS/Linux) or `powershell -c "irm https://astral.sh/uv/install.ps1 | iex"` (Windows). uv fetches Python 3.12 for you if it isn't already installed.
+
## Setup
```bash
-# 1. Install dependencies
+# 1. Install dependencies (also runs `uv sync` for the Python agent)
npm install
# 2. Set your API key
@@ -41,7 +47,7 @@ cp .env.example .env
npm run dev
```
-This starts both the Next.js frontend (port 3000) and the LangGraph agent (port 8125).
+This starts both the Next.js frontend (port 3000) and the LangGraph agent (port 8125). On Windows the same `npm` scripts run the `.bat` equivalents under `scripts/`.
## Example Content
diff --git a/generative_ui_agents/ai-knowledge-explorer/scripts/run-agent.bat b/generative_ui_agents/ai-knowledge-explorer/scripts/run-agent.bat
new file mode 100644
index 00000000..8f2545f9
--- /dev/null
+++ b/generative_ui_agents/ai-knowledge-explorer/scripts/run-agent.bat
@@ -0,0 +1,3 @@
+@echo off
+cd /d "%~dp0..\agent"
+npx @langchain/langgraph-cli dev --port 8125 --no-browser
diff --git a/generative_ui_agents/ai-knowledge-explorer/scripts/setup-agent.bat b/generative_ui_agents/ai-knowledge-explorer/scripts/setup-agent.bat
new file mode 100644
index 00000000..39408dc2
--- /dev/null
+++ b/generative_ui_agents/ai-knowledge-explorer/scripts/setup-agent.bat
@@ -0,0 +1,3 @@
+@echo off
+cd /d "%~dp0..\agent"
+uv sync