a2a-java - GitLite

KO | EN

gitlite — search

#javascript #python #react #ai #typescript #android #docker #nodejs #windows #awesome #kubernetes #pytorch #security #openai

a2a-java

(★ 475)

Official Java SDK for the Agent2Agent (A2A) Protocol

File Explorer

Download Latest Version (.zip)

Showing a partial file list — download the zip above to see everything.

- - compatibility_0.3.md
  - EVENTQUEUE.md
- skills
- validate-jbang-versions.groovy
- - bug-report.yml
  - feature-request.yml
- - build-and-test.yml
  - build-with-release-profile-run.yml
  - build-with-release-profile.yml
  - check-site.yml
  - cloud-deployment-example.yml
  - conventional-commits.yml
  - create-github-release.yml
  - deploy-site.yml
  - itk-nightly.yaml
  - itk.yaml
  - release-please.yml
  - release-to-maven-central.yml
  - run-tck.yml
  - verify-grpc-generation.yml
- dependabot.yml
- PULL_REQUEST_TEMPLATE.md
- - pom.xml
- - pom.xml
- - pom.xml
- - pom.xml
- README.md
- - pom.xml
- pom.xml
- - pom.xml
- - pom.xml
- - pom.xml
- - pom.xml
- pom.xml
- - 404.html
  - announces.html
  - community.md
  - contributing.md
  - index.html
  - search-index.json
  - sitemap.xml
- - authors.yml
  - menu.yml
- .gitignore
- mvnw
- mvnw.cmd
- pom.xml
- README.md
.gitignore
AGENTS.md
CLAUDE.md
CODE_OF_CONDUCT.md
COMMUNITY_ARTICLES.md
CONTRIBUTING.md
CONTRIBUTING_INTEGRATIONS.md
LICENSE
README.md
RELEASE.md
SECURITY.md

# Installation Guide

1. Get the code

git clone https://github.com/a2aproject/a2a-java

Downloads the entire project code from GitHub to your computer.

cd a2a-java

Moves into the project folder you just downloaded.

2. Maven (Java)

Medium Recommended

Prerequisites

Git Needed to download the project code from GitHub.
JDK (Java) Required to build and run Java projects.
Maven The build tool used for the mvn command.

mvn clean install

Installs dependencies and builds the project using Maven.

✅ A BUILD SUCCESS message means it worked. The output is created under target/.

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# A2A Java SDK

[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://raw.githubusercontent.com/a2aproject/a2a-java/main/LICENSE)

<html>
   <h2 align="center">
   <img src="https://raw.githubusercontent.com/google-a2a/A2A/refs/heads/main/docs/assets/a2a-logo-black.svg" width="256" alt="A2A Logo"/>
   </h2>
   <h3 align="center">A Java library that helps run agentic applications as A2A servers following the <a href="https://a2a-protocol.org/">Agent2Agent (A2A) Protocol</a>.</h3>
</html>

A multi-module Maven library providing client and server support for A2A agent communication over JSON-RPC, gRPC, and REST transports.

## Documentation

Full documentation is available at **[a2aproject.github.io/a2a-java](https://a2aproject.github.io/a2a-java/)**.

- [Server Guide](https://a2aproject.github.io/a2a-java/server) — Run your agentic Java application as an A2A server
- [Client Guide](https://a2aproject.github.io/a2a-java/client) — Communicate with any A2A-compliant agent
- [Community Articles](https://a2aproject.github.io/a2a-java/community) — Tutorials, blog posts, and videos
- [Announcements](https://a2aproject.github.io/a2a-java/announces) — Release announcements and project news
- [Contributing](https://a2aproject.github.io/a2a-java/contributing) — Developer guide for contributing

## Quick Start

Requires Java 17+.

Add the A2A Java SDK reference server for JSON-RPC to your Maven project:

```xml
<dependency>
    <groupId>org.a2aproject.sdk</groupId>
    <artifactId>a2a-java-sdk-reference-jsonrpc</artifactId>
     
    <version>${org.a2aproject.sdk.version}</version>
</dependency>
```

See the [Server Guide](https://a2aproject.github.io/a2a-java/server) for full setup instructions.

## Build

```bash
mvn clean install
```

### Regeneration of gRPC files

We copy https://github.com/a2aproject/A2A/blob/main/specification/grpc/a2a.proto to the [`spec-grpc/`](./spec-grpc) project, and adjust the `java_package` option to be as follows:
```
option java_package = "org.a2aproject.sdk.grpc";
```
Then build the `spec-grpc` module with `mvn clean install -Dskip.protobuf.generate=false` to regenerate the gRPC classes in the `org.a2aproject.sdk.grpc` package.

## Examples

- [Hello World Server](examples/helloworld/server/README.md) — Java A2A server with a Python client
- [Hello World Client](examples/helloworld/client/README.md) — Java A2A client with a Python server
- [a2a-samples](https://github.com/a2aproject/a2a-samples/tree/main/samples/java/agents) — More agent examples

## Server Integrations

Community contributed integrations with various Java runtimes:

* **Quarkus** — This project contains the reference implementations for JSON-RPC, gRPC, and HTTP+JSON (REST) transports.
* **Jakarta EE** — [a2a-jakarta](https://github.com/wildfly-extras/a2a-jakarta) works with any runtime supporting the [Jakarta EE Web Profile](https://jakarta.ee/specifications/webprofile/).

To contribute an integration, see [CONTRIBUTING_INTEGRATIONS.md](CONTRIBUTING_INTEGRATIONS.md).

## Extras

See the [`extras`](./extras/README.md) folder for optional add-ons (OpenTelemetry, JPA-backed task store, Kafka-based replicated queue manager, Vert.x and Android HTTP clients).

## License

This project is licensed under the terms of the [Apache 2.0 License](LICENSE).

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines.