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>