From 39476def014b7911a5b21932db4d19e481ce606c Mon Sep 17 00:00:00 2001 From: Krishna Thota Date: Mon, 19 May 2025 19:42:27 -0700 Subject: [PATCH 1/5] update readme --- README.md | 40 +++++++++++++++++++++++----------------- 1 file changed, 23 insertions(+), 17 deletions(-) diff --git a/README.md b/README.md index fb9db582..93c5bd6e 100644 --- a/README.md +++ b/README.md @@ -1,34 +1,40 @@ -# A2A SDK (Prototype) +# A2A Python SDK -Early version of the A2A Python SDK. +A python library that helps run agentic applications as A2AServers. -## Install SDK +## Installation -```bash -pip install . -``` +You can install the a2a-sdk using either `uv` or `pip`. -## Verify install +## Prerequisites +* Python 3.13+ +* `uv` (optional, but recommended) or `pip` -```py -import a2a -``` +### using `uv` -## Run Helloworld - -Run Remote Agent +When you're working within a uv project or a virtual environment managed by uv, the preferred way to add packages is using uv add. ```bash -cd examples/helloworld -python __main__.py +uv add a2a-sdk ``` -In another terminal, run the client +### using `pip` + +If you prefer to use pip, the standard Python package installer, you can install a2a-sdk as follows ```bash -python test_client.py +pip install a2a-sdk ``` +## Examples + +A simple hello world example agent is available here: + +* [Hello World example](https://github.com/google/a2a-python/tree/main/examples/helloworld) + +You can also find more examples [here](https://github.com/google/A2A/tree/main/samples/python/agents) + + ## License This project is licensed under the terms of the [Apache 2.0 License](LICENSE). From 9bbca36c970155cb88b34e2a73a588c12e2d6999 Mon Sep 17 00:00:00 2001 From: Krishna Thota Date: Mon, 19 May 2025 19:46:59 -0700 Subject: [PATCH 2/5] update readme --- README.md | 15 +++++++++++++-- 1 file changed, 13 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 93c5bd6e..a96997f5 100644 --- a/README.md +++ b/README.md @@ -28,9 +28,20 @@ pip install a2a-sdk ## Examples -A simple hello world example agent is available here: +### [Helloworld Example](https://github.com/google/a2a-python/tree/main/examples/helloworld) -* [Hello World example](https://github.com/google/a2a-python/tree/main/examples/helloworld) +1. Run Remote Agent + +```bash +cd examples/helloworld +uv run . +``` + +2. In another terminal, run the client + +```bash +uv run test_client.py +``` You can also find more examples [here](https://github.com/google/A2A/tree/main/samples/python/agents) From 2ab6057f9cfc1cada2c06f801dff545efc1efc76 Mon Sep 17 00:00:00 2001 From: Holt Skinner <13262395+holtskinner@users.noreply.github.com> Date: Mon, 19 May 2025 19:47:28 -0700 Subject: [PATCH 3/5] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index a96997f5..e734834e 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # A2A Python SDK -A python library that helps run agentic applications as A2AServers. +A Python library that helps run agentic applications as A2AServers. ## Installation From daa261c92e2fac43be21163a82745dfccdbeeea1 Mon Sep 17 00:00:00 2001 From: Holt Skinner Date: Mon, 19 May 2025 19:49:25 -0700 Subject: [PATCH 4/5] Formatting --- README.md | 32 ++++++++++++++++---------------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/README.md b/README.md index e734834e..68401eea 100644 --- a/README.md +++ b/README.md @@ -1,26 +1,27 @@ # A2A Python SDK -A Python library that helps run agentic applications as A2AServers. +A Python library that helps run agentic applications as A2AServers following the [Agent2Agent (A2A) Protocol](https://google.github.io/A2A/). ## Installation -You can install the a2a-sdk using either `uv` or `pip`. +You can install the A2A SDK using either `uv` or `pip`. ## Prerequisites -* Python 3.13+ -* `uv` (optional, but recommended) or `pip` -### using `uv` +- Python 3.13+ +- `uv` (optional, but recommended) or `pip` -When you're working within a uv project or a virtual environment managed by uv, the preferred way to add packages is using uv add. +### Using `uv` + +When you're working within a uv project or a virtual environment managed by uv, the preferred way to add packages is using uv add. ```bash uv add a2a-sdk ``` -### using `pip` +### Using `pip` -If you prefer to use pip, the standard Python package installer, you can install a2a-sdk as follows +If you prefer to use pip, the standard Python package installer, you can install `a2a-sdk` as follows ```bash pip install a2a-sdk @@ -32,20 +33,19 @@ pip install a2a-sdk 1. Run Remote Agent -```bash -cd examples/helloworld -uv run . -``` + ```bash + cd examples/helloworld + uv run . + ``` 2. In another terminal, run the client -```bash -uv run test_client.py -``` + ```bash + uv run test_client.py + ``` You can also find more examples [here](https://github.com/google/A2A/tree/main/samples/python/agents) - ## License This project is licensed under the terms of the [Apache 2.0 License](LICENSE). From f64af7b09f50096f03b235c02b5328b15d277c2f Mon Sep 17 00:00:00 2001 From: Holt Skinner Date: Mon, 19 May 2025 19:50:03 -0700 Subject: [PATCH 5/5] spelling --- .github/actions/spelling/allow.txt | 2 ++ 1 file changed, 2 insertions(+) diff --git a/.github/actions/spelling/allow.txt b/.github/actions/spelling/allow.txt index 20747808..dd4dd5ec 100644 --- a/.github/actions/spelling/allow.txt +++ b/.github/actions/spelling/allow.txt @@ -4,6 +4,7 @@ AError ARequest ARun AServer +AServers AStarlette EUR GBP @@ -13,6 +14,7 @@ JSONRPCt Llm aconnect adk +agentic autouse cla cls