Spring AI integrations and ecosystem extensions for Java applications.
MCP · Vector stores · Chat memory · RAG · Observability
Documentation · Quick Start · ARGI · 简体中文
ARGI stands for Agent Runtime and Graph Intelligence and is pronounced "AR-jee" (/ˈɑːr.dʒiː/). ARGI Extensions provides Spring AI integrations for MCP, vector stores, chat memory, RAG, prompt management, and observability. Use these modules directly with Spring AI or combine them with the ARGI framework.
- MCP: registry, router, distributed service, and gateway modules.
- Data and memory: vector stores and chat memory repositories for common databases and cloud services.
- RAG: reusable retrieval-augmented generation components.
- Operations: Nacos prompt management and ARMS observation integration.
Requirements: JDK 17 or later and Maven 3.9.1 or later. Install the local development modules with Maven:
git clone --depth=1 https://github.com/agentic-ai-java/argi-extensions.git
cd argi-extensions
# Bootstrap the unpublished loop core and its test fixtures (also done by CI).
git clone --no-checkout https://github.com/agentic-ai-java/argi.git target/argi-upstream
git -C target/argi-upstream checkout --detach 62701a3c7709075aa389c3d5f8af8533a2081448
git -C target/argi-upstream apply ../../tools/github-actions/setup-loop-core/snakeyaml.patch
(cd target/argi-upstream && ./mvnw -B -ntp -pl :argi-loop-core -am -DskipTests install)
mvn -DskipTests installThe pinned upstream revision provides argi-loop-core:2.1.0-RC2-SNAPSHOT,
which is required by the graph persistence modules and is not yet published,
along with its runtime dependencies and their test fixtures.
The build patch declares the direct SnakeYAML dependency missing from that revision.
Use -DskipTests for this bootstrap: test compilation must remain enabled to
produce the test JAR used by Redis persistence. Update the pin in
tools/github-actions/setup-loop-core/action.yml and this example together
when changing the loop core dependency.
Import the Extensions BOM and add the starters you need to your project:
<dependencyManagement>
<dependencies>
<dependency>
<groupId>io.github.agentic-ai-java</groupId>
<artifactId>argi-extensions-bom</artifactId>
<version>2.1.0-RC1</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<dependencies>
<dependency>
<groupId>io.github.agentic-ai-java</groupId>
<artifactId>argi-starter-mcp-registry</artifactId>
</dependency>
</dependencies>| Module | Description |
|---|---|
| MCP | Model Context Protocol registry, router, gateway, and discovery integrations |
| Vector Stores | AnalyticDB, OceanBase, OpenSearch, TableStore, and Tair vector stores |
| Memory Repository | Chat memory implementations for Redis, MongoDB, Elasticsearch, Memcached, TableStore, and Mem0 |
| RAG | Reusable retrieval-augmented generation components |
| Starters | Spring Boot starters for convenient dependency management |
| Auto-Configurations | Spring Boot auto-configuration modules |
| Prompt | Dynamic prompt management with Nacos integration |
| Observation | Application observability and ARMS integration |
Issues and pull requests are welcome. Report problems and suggestions through GitHub Issues.
ARGI Extensions is available under the Apache License 2.0.