Installation

AgentScope Java supports multiple models, RAG stores, and extensions, each requiring different third-party SDKs. Bundling everything together would bloat your project, so we offer two ways to add dependencies:

All-in-one: Single dependency with common model extensions (OpenAI / Gemini / Anthropic / DashScope / Ollama) and MCP SDK included, get started quickly
Core + extensions: Minimal core package, add extension modules as needed, for strict dependency control

For most cases, all-in-one is enough. Switch to core + extensions when you need fine-grained dependency control. Requirements: JDK 17+

Dependency Options

Approach	Use Case	Features
all-in-one	Quick start, most users	Single dependency, includes common model extensions and MCP SDK
core + extensions	Fine-grained control	On-demand imports, minimal dependencies

All-in-One (Recommended)

Maven:

<dependency>
    <groupId>io.agentscope</groupId>
    <artifactId>agentscope</artifactId>
    <version>2.0.0</version>
</dependency>

Gradle:

implementation 'io.agentscope:agentscope:2.0.0'

Included Dependencies

The all-in-one package (io.agentscope:agentscope) already bundles the common model extensions and their required third-party SDKs. You do not need to add model-provider SDKs separately:

OpenAI model support (agentscope-extensions-model-openai, native HTTP — no openai-java required)
Google Gemini model support (includes Google GenAI SDK)
Anthropic model support (includes Anthropic Java SDK)
DashScope model support (Qwen series)
Ollama model support
MCP SDK (Model Context Protocol)
Reactor Core, Jackson, SLF4J (base frameworks)

Additional Dependencies

Add the following only when using core + extensions, or when you need runtime drivers / optional components that are not covered above. All-in-one users do not need to manually add OpenAI / Gemini / Anthropic / DashScope / Ollama SDKs for the models listed in the previous section.

Feature	Dependency	Maven Coordinates
Mem0 Long-term Memory	OkHttp	`com.squareup.okhttp3:okhttp`
ReME Long-term Memory	OkHttp	`com.squareup.okhttp3:okhttp`
Bailian RAG	Bailian SDK	`com.aliyun:bailian20231229`
Qdrant RAG	Qdrant Client	`io.qdrant:client`
PgVector RAG	PostgreSQL Driver + pgvector	`org.postgresql:postgresql` + `com.pgvector:pgvector`
Dify RAG	OkHttp	`com.squareup.okhttp3:okhttp`
RAGFlow RAG	OkHttp	`com.squareup.okhttp3:okhttp`
HayStack RAG	OkHttp	`com.squareup.okhttp3:okhttp`
Elasticsearch RAG	Elasticsearch Java Client	`co.elastic.clients:elasticsearch-java`
MySQL Session	MySQL Connector	`com.mysql:mysql-connector-j`
Redis Session	Jedis	`redis.clients:jedis`
PDF Processing	Apache PDFBox	`org.apache.pdfbox:pdfbox`
Word Processing	Apache POI	`org.apache.poi:poi-ooxml`
Document Processing	Apache Tika Core + Apache Tika Parsers	`org.apache.tika:tika-core` + `org.apache.tika:tika-parsers-standard-package`
Nacos Registry	Nacos Client	`com.alibaba.nacos:nacos-client`

Example: Using Qdrant RAG + PDF Processing

<!-- Add on top of agentscope when the runtime drivers are not already available -->
<dependency>
    <groupId>io.qdrant</groupId>
    <artifactId>client</artifactId>
</dependency>
<dependency>
    <groupId>org.apache.pdfbox</groupId>
    <artifactId>pdfbox</artifactId>
</dependency>

Studio Integration

Connect to AgentScope Studio for visualization and debugging:

Dependency	Maven Coordinates
OkHttp	`com.squareup.okhttp3:okhttp`
Socket.IO Client	`io.socket:socket.io-client`
OpenTelemetry API	`io.opentelemetry:opentelemetry-api`
OpenTelemetry OTLP Exporter	`io.opentelemetry:opentelemetry-exporter-otlp`
OpenTelemetry Reactor	`io.opentelemetry.instrumentation:opentelemetry-reactor-3.1`

Full configuration:

<!-- Add on top of agentscope -->
<dependency>
    <groupId>com.squareup.okhttp3</groupId>
    <artifactId>okhttp</artifactId>
</dependency>
<dependency>
    <groupId>io.socket</groupId>
    <artifactId>socket.io-client</artifactId>
</dependency>
<dependency>
    <groupId>io.opentelemetry</groupId>
    <artifactId>opentelemetry-api</artifactId>
</dependency>
<dependency>
    <groupId>io.opentelemetry</groupId>
    <artifactId>opentelemetry-exporter-otlp</artifactId>
</dependency>
<dependency>
    <groupId>io.opentelemetry.instrumentation</groupId>
    <artifactId>opentelemetry-reactor-3.1</artifactId>
</dependency>

Core + Extensions

For fine-grained dependency control, use agentscope-core with extension modules: Maven:

<dependency>
    <groupId>io.agentscope</groupId>
    <artifactId>agentscope-core</artifactId>
    <version>2.0.0</version>
</dependency>

Gradle:

implementation 'io.agentscope:agentscope-core:2.0.0'

Extension Modules

Long-term Memory

Module	Feature	Maven Coordinates
agentscope-extensions-mem0	Mem0 Long-term Memory	`io.agentscope:agentscope-extensions-mem0`
agentscope-extensions-reme	ReME Long-term Memory	`io.agentscope:agentscope-extensions-reme`

RAG

Module	Feature	Maven Coordinates
agentscope-extensions-rag-bailian	Bailian RAG	`io.agentscope:agentscope-extensions-rag-bailian`
agentscope-extensions-rag-simple	Simple RAG (Qdrant, Milvus, PgVector, InMemory, Elasticsearch)	`io.agentscope:agentscope-extensions-rag-simple`
agentscope-extensions-rag-dify	Dify RAG	`io.agentscope:agentscope-extensions-rag-dify`
agentscope-extensions-rag-ragflow	RAGFlow RAG	`io.agentscope:agentscope-extensions-rag-ragflow`
agentscope-extensions-rag-haystack	HayStack RAG	`io.agentscope:agentscope-extensions-rag-haystack`

Session Storage

Module	Feature	Maven Coordinates
agentscope-extensions-session-mysql	MySQL Session	`io.agentscope:agentscope-extensions-session-mysql`
agentscope-extensions-session-redis	Redis Session	`io.agentscope:agentscope-extensions-session-redis`

Multi-Agent Collaboration

Module	Feature	Maven Coordinates
agentscope-extensions-a2a-client	A2A Client	`io.agentscope:agentscope-extensions-a2a-client`
agentscope-extensions-a2a-server	A2A Server	`io.agentscope:agentscope-extensions-a2a-server`

Scheduling

Module	Feature	Maven Coordinates
agentscope-extensions-scheduler-common	Scheduler Common	`io.agentscope:agentscope-extensions-scheduler-common`
agentscope-extensions-scheduler-xxl-job	XXL-Job Scheduler	`io.agentscope:agentscope-extensions-scheduler-xxl-job`
agentscope-extensions-scheduler-quartz	Quartz Scheduler	`io.agentscope:agentscope-extensions-scheduler-quartz`

User Interface

Module	Feature	Maven Coordinates
agentscope-extensions-studio	Studio Integration	`io.agentscope:agentscope-extensions-studio`
agentscope-extensions-agui	AG-UI Protocol	`io.agentscope:agentscope-extensions-agui`

Extension modules automatically include their required third-party dependencies.

Example: Core + Mem0 Extension

<!-- Add on top of agentscope-core -->
<dependency>
    <groupId>io.agentscope</groupId>
    <artifactId>agentscope-extensions-mem0</artifactId>
    <version>2.0.0</version>
</dependency>

Framework Integration

Spring Boot

<dependency>
    <groupId>io.agentscope</groupId>
    <artifactId>agentscope-spring-boot-starter</artifactId>
    <version>2.0.0</version>
</dependency>

Additional starters:

Starter	Feature	Maven Coordinates
agentscope-a2a-spring-boot-starter	A2A Integration	`io.agentscope:agentscope-a2a-spring-boot-starter`
agentscope-agui-spring-boot-starter	AG-UI Integration	`io.agentscope:agentscope-agui-spring-boot-starter`
agentscope-chat-completions-web-starter	Chat Completions Web Integration	`io.agentscope:agentscope-chat-completions-web-starter`
agentscope-nacos-spring-boot-starter	Nacos Integration	`io.agentscope:agentscope-nacos-spring-boot-starter`

Quarkus

<dependency>
    <groupId>io.agentscope</groupId>
    <artifactId>agentscope-quarkus-extension</artifactId>
    <version>2.0.0</version>
</dependency>

Micronaut

<dependency>
    <groupId>io.agentscope</groupId>
    <artifactId>agentscope-micronaut-extension</artifactId>
    <version>2.0.0</version>
</dependency>

Quick Start

Features

Multi Agent

Harness

Dependency Options

All-in-One (Recommended)

Included Dependencies

Additional Dependencies

Example: Using Qdrant RAG + PDF Processing

Studio Integration

Core + Extensions

Extension Modules

Long-term Memory

RAG

Session Storage

Multi-Agent Collaboration

Scheduling

User Interface

Example: Core + Mem0 Extension

Framework Integration

Spring Boot

Quarkus

Micronaut

​Dependency Options

​All-in-One (Recommended)

​Included Dependencies

​Additional Dependencies

​Example: Using Qdrant RAG + PDF Processing

​Studio Integration

​Core + Extensions

​Extension Modules

​Long-term Memory

​RAG

​Session Storage

​Multi-Agent Collaboration

​Scheduling

​User Interface

​Example: Core + Mem0 Extension

​Framework Integration

​Spring Boot

​Quarkus

​Micronaut

Dependency Options

All-in-One (Recommended)

Included Dependencies

Additional Dependencies

Example: Using Qdrant RAG + PDF Processing

Studio Integration

Core + Extensions

Extension Modules

Long-term Memory

RAG

Session Storage

Multi-Agent Collaboration

Scheduling

User Interface

Example: Core + Mem0 Extension

Framework Integration

Spring Boot

Quarkus

Micronaut