Spring Boot Guides

These guides walk you through integrating Memory Service with a Spring Boot application using Spring AI. Start with Getting Started to build a basic AI agent with persistent memory, then progressively add features like conversation history, search, forking, and more.

Prerequisites

Before starting any of the tutorials below, make sure you have the following installed:

Java 21 or later
Maven (or use the repo-local ./java/mvnw -f java/pom.xml wrapper)
Docker (for Memory Service)
curl and jq installed

Build from Source

Note: This project is currently in the proof-of-concept (POC) phase and has not yet published any releases. You’ll need to build it from source before using it in your project.

Clone the repository and build all modules:

git clone https://github.com/chirino/memory-service.git
cd memory-service
./java/mvnw -f java/pom.xml -DskipTests clean install

This installs all project artifacts to your local Maven repository.

Guides

Getting Started

Create a Spring Boot AI agent and connect it to Memory Service for persistent conversation memory.

Conversation History

Record conversation history and expose APIs for frontend applications to display messages.

Indexing and Search

Add search indexing to your conversation history entries and expose a search API for frontend applications.

Conversation Forking

Let users branch off from any point in a conversation to explore alternative paths.

Response Recording and Resumption

Implement streaming responses with resume and cancellation support, so users can reconnect after a disconnect.

Implement conversation sharing and ownership transfer between users.

Docker Compose

Use Spring Boot’s built-in Docker Compose support to automatically start Memory Service during development.