doc: Add README.MD

Author: batprem

examples/no-llm-framework/README.md

@@ -0,0 +1,72 @@
+# Example: Using a2a-python SDK Without an LLM Framework
+
+This repository demonstrates how to set up and use the [a2a-python SDK](https://github.com/google/a2a-python) to create a simple server and client, without relying on any large language model (LLM) framework.
+
+## Overview
+
+- **A2A (Agent-to-Agent):** A protocol and SDK for building interoperable AI agents.
+- **This Example:** Shows how to run a basic A2A server and client, exchange messages, and view the response.
+
+## Prerequisites
+
+- Python 3.13+
+- [uv](https://github.com/astral-sh/uv) (for fast dependency management and running)
+- An API key for Gemini (set as `GEMINI_API_KEY`)
+
+## Installation
+
+1. **Clone the repository:**
+   ```bash
+   git clone <this-repo-url>
+   cd <repo-directory>
+   ```
+
+2. **Install dependencies:**
+   ```bash
+   uv pip install -e .
+   ```
+
+3. **Set environment variables:**
+   ```bash
+   export GEMINI_API_KEY=your-gemini-api-key
+   ```
+
+   Or create a `.env` file with:
+   ```
+   GEMINI_API_KEY=your-gemini-api-key
+   ```
+
+## Running the Example
+
+### 1. Start the Server
+
+```bash
+uv run --env-file .env python -m src.no_llm_framework.server.__main__
+```
+- The server will start on port 9999.
+
+### 2. Run the Client
+
+In a new terminal:
+
+```bash
+uv run --env-file .env python -m src.no_llm_framework.client --question "What is A2A protocol?"
+```
+
+- The client will connect to the server and send a request.
+
+### 3. View the Response
+
+- The response from the client will be saved to [response.xml](./response.xml).
+
+## File Structure
+
+- `src/no_llm_framework/server/`: Server implementation.
+- `src/no_llm_framework/client/`: Client implementation.
+- `response.xml`: Example response from the client.
+
+## Troubleshooting
+
+- **Missing dependencies:** Make sure you have `uv` installed.
+- **API key errors:** Ensure `GEMINI_API_KEY` is set correctly.
+- **Port conflicts:** Make sure port 9999 is free.