Installation¶

AgentScope Java supports multiple models, RAG backends, 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 DashScope SDK 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 DashScope 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>1.0.7</version>
</dependency>

Gradle:

implementation 'io.agentscope:agentscope:1.0.7'

Included Dependencies¶

The all-in-one package includes these dependencies by default:

DashScope SDK (Qwen series models)
MCP SDK (Model Context Protocol)
Reactor Core, Jackson, SLF4J (base frameworks)

Additional Dependencies¶

When using other models or features, add the corresponding dependencies:

Feature	Dependency	Maven Coordinates
OpenAI Models	OpenAI Java SDK	`com.openai:openai-java`
Google Gemini Models	Google GenAI SDK	`com.google.genai:google-genai`
Anthropic Models	Anthropic Java SDK	`com.anthropic:anthropic-java`
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`
Nacos Registry	Nacos Client	`com.alibaba.nacos:nacos-client`

Example: Using OpenAI Models¶

<!-- Add on top of agentscope -->
<dependency>
    <groupId>com.openai</groupId>
    <artifactId>openai-java</artifactId>
</dependency>

Example: Using Qdrant RAG + PDF Processing¶

<!-- Add on top of agentscope -->
<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>1.0.7</version>
</dependency>

Gradle:

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

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`
agentscope-extensions-autocontext-memory	AutoContext Memory	`io.agentscope:agentscope-extensions-autocontext-memory`

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`

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>1.0.7</version>
</dependency>

Framework Integration¶

Spring Boot¶

<dependency>
    <groupId>io.agentscope</groupId>
    <artifactId>agentscope-spring-boot-starter</artifactId>
    <version>1.0.7</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`

Quarkus¶

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

Micronaut¶

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