ruslanmv commited on
Commit
b8a55b3
·
1 Parent(s): 8c4c4be

First commit

Browse files
Files changed (3) hide show
  1. .gitattributes +1 -0
  2. README.md +10 -5
  3. assets/a2a-validator.gif +3 -0
.gitattributes CHANGED
@@ -1 +1,2 @@
1
  assets/*.png filter=lfs diff=lfs merge=lfs -text
 
 
1
  assets/*.png filter=lfs diff=lfs merge=lfs -text
2
+ assets/*.gif filter=lfs diff=lfs merge=lfs -text
README.md CHANGED
@@ -8,7 +8,9 @@ pinned: false
8
  ---
9
 
10
  # A2A Validator 🔬
11
- ![](assets/2025-10-05-00-49-00.png)
 
 
12
  **A2A Validator** is a focused web app for testing AI agents that speak the **A2A (Agent-to-Agent) protocol**. Paste an agent URL, connect, and the app will fetch the agent’s discovery document, validate it against the protocol, and provide a real-time message terminal. It’s a tool designed for the build/integration loop: tight feedback, zero ceremony.
13
 
14
  The backend runs on **FastAPI** and **Socket.IO**, with a lightweight HTML/JS frontend. The core validator checks both the static **Agent Card** and the live events an agent emits. If the optional `a2a-sdk` is present, it's used for card resolution and streaming; if not, the app gracefully falls back to a "plain HTTP" mode for basic card linting.
@@ -65,8 +67,8 @@ You can run A2A Validator as a single container. Choose your preferred registry,
65
 
66
  > Replace placeholders with your image path and tag:
67
  >
68
- > * Docker Hub: `docker.io/russlanmv/a2a-validator`
69
- > * GHCR: `ghcr.io/<owner>/a2a-validator`
70
 
71
  ### Option 1 — Docker Hub
72
 
@@ -89,7 +91,7 @@ echo "$GITHUB_TOKEN" | docker login ghcr.io -u <github-username> --password-stdi
89
  Then pull and run:
90
 
91
  ```bash
92
- docker pull ghcr.io/<owner>/a2a-validator
93
 
94
  docker run --rm -p 7860:7860 ghcr.io/ruslanmv/a2a-validator
95
  ```
@@ -164,6 +166,9 @@ sequenceDiagram
164
  S->>S: Validate each response
165
  S-->>U: 'agent_response' with validation notes
166
  ```
 
 
 
167
 
168
  -----
169
 
@@ -190,4 +195,4 @@ Static assets are served from `app/static` and templates from `app/templates`. T
190
 
191
  ## 📜 License
192
 
193
- This project is licensed under the **Apache-2.0 License**. Use it, tweak it, ship it.
 
8
  ---
9
 
10
  # A2A Validator 🔬
11
+ ![](assets/a2a-validator.gif)
12
+
13
+
14
  **A2A Validator** is a focused web app for testing AI agents that speak the **A2A (Agent-to-Agent) protocol**. Paste an agent URL, connect, and the app will fetch the agent’s discovery document, validate it against the protocol, and provide a real-time message terminal. It’s a tool designed for the build/integration loop: tight feedback, zero ceremony.
15
 
16
  The backend runs on **FastAPI** and **Socket.IO**, with a lightweight HTML/JS frontend. The core validator checks both the static **Agent Card** and the live events an agent emits. If the optional `a2a-sdk` is present, it's used for card resolution and streaming; if not, the app gracefully falls back to a "plain HTTP" mode for basic card linting.
 
67
 
68
  > Replace placeholders with your image path and tag:
69
  >
70
+ > * Docker Hub: `docker.io/ruslanmv/a2a-validator`
71
+ > * GHCR: `ghcr.io/ruslanmv/a2a-validator`
72
 
73
  ### Option 1 — Docker Hub
74
 
 
91
  Then pull and run:
92
 
93
  ```bash
94
+ docker pull ghcr.io/ruslanmv/a2a-validator
95
 
96
  docker run --rm -p 7860:7860 ghcr.io/ruslanmv/a2a-validator
97
  ```
 
166
  S->>S: Validate each response
167
  S-->>U: 'agent_response' with validation notes
168
  ```
169
+ ### Example card
170
+ ![](assets/2025-10-05-00-49-00.png)
171
+
172
 
173
  -----
174
 
 
195
 
196
  ## 📜 License
197
 
198
+ This project is licensed under the **Apache-2.0 License**. Use it, tweak it, ship it.
assets/a2a-validator.gif ADDED

Git LFS Details

  • SHA256: 8c26065a44f94bfce6006cc40e248e9ec40799d2ea3a1c06c16baad3d7623c17
  • Pointer size: 132 Bytes
  • Size of remote file: 7.45 MB