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.11</version>
</dependency>

Gradle:

implementation 'io.agentscope:agentscope:1.0.11'

Included Dependencies¶

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

DashScope model support (Qwen series models, via native HTTP calls, no additional SDK required)
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`
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 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.11</version>
</dependency>

Gradle:

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

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`
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>1.0.11</version>
</dependency>

Framework Integration¶

Spring Boot¶

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

Micronaut¶

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