Samples

New to Akka? Start here:

Author your first Akka service to get a minimal "Hello World!" Akka service and run it locally.

Samples are available that demonstrate important patterns and abstractions. These can be cloned from their respective repositories. Please refer to the README file in each repository for setup and usage instructions.

Description	Source download	Level
Build a shopping cart	Github Repository	Beginner
AI agent that performs a RAG workflow using Langchain4J. Illustrates how to create embeddings for vector databases, how to consume LLMs and maintain conversation history, use RAG to add knowledge to fixed LLMs, and expose it all as a streaming service. It uses MongoDB Atlas and OpenAI.	Github Repository	Intermediate
AI agent that creates personalized travel itineraries. Illustrates reliable interaction with a LLM using Langchain4J and a workflow. Entities are used for durable state of user preferences and generated trips.	Github Repository	Beginner
AI agent that leverages a LLM to process medical discharge summaries and assign tags, while also enabling human verification and comparative analysis. Interactions with OpenAI LLM using the OpenAI Java SDK and a workflow.	Github Repository	Intermediate
AI agent that creates release notes summaries, every time there is a release from set up GitHub repositories. Interactions with Anthropic Claude is using the Anthropic Java SDK. Using tools to retrieve detailed information from GitHub. Entities are used for storing release summaries. Timed action looks for new releases periodically and creates the summary using the LLM.	Github Repository	Intermediate
The real-estate customer service agent is demonstrating how to combine Akka features with an LLM model. It illustrates an agentic workflow for customer service. It processes incoming real-estate inquiries, analyzes the content to extract details, provides follow-up when needed and saves the collected information for future reference.	Github Repository	Intermediate
This app represents an agency that searches for flights and accommodations. It’s composed by an LLM (Anthropic) using Spring AI and tools to find flights, accommodations and sending mails.	Github Repository	Intermediate
Demonstrating how to build a multi-agent system using Akka and an LLM model. A workflow manages the user query process, handling the sequential steps of agent selection, plan creation, execution, and summarization.	Github Repository	Advanced
A customer registry with query capabilities	customer-registry-quickstart.zip	Intermediate
A funds transfer workflow between two wallets	Github Repository	Intermediate
A user registration service implemented as a Choreography Saga	Github Repository	Advanced
Akka Chess: a complete, resilient, automatically scalable, event-sourced chess game	Github Repository	Advanced

Description

Source download

Level

Build a shopping cart

Github Repository

Beginner

AI agent that performs a RAG workflow using Langchain4J. Illustrates how to create embeddings for vector databases, how to consume LLMs and maintain conversation history, use RAG to add knowledge to fixed LLMs, and expose it all as a streaming service. It uses MongoDB Atlas and OpenAI.

Github Repository

Intermediate

AI agent that creates personalized travel itineraries. Illustrates reliable interaction with a LLM using Langchain4J and a workflow. Entities are used for durable state of user preferences and generated trips.

Github Repository

Beginner

AI agent that leverages a LLM to process medical discharge summaries and assign tags, while also enabling human verification and comparative analysis. Interactions with OpenAI LLM using the OpenAI Java SDK and a workflow.

Github Repository

Intermediate

AI agent that creates release notes summaries, every time there is a release from set up GitHub repositories. Interactions with Anthropic Claude is using the Anthropic Java SDK. Using tools to retrieve detailed information from GitHub. Entities are used for storing release summaries. Timed action looks for new releases periodically and creates the summary using the LLM.

Github Repository

Intermediate

The real-estate customer service agent is demonstrating how to combine Akka features with an LLM model. It illustrates an agentic workflow for customer service. It processes incoming real-estate inquiries, analyzes the content to extract details, provides follow-up when needed and saves the collected information for future reference.

Github Repository

Intermediate

This app represents an agency that searches for flights and accommodations. It’s composed by an LLM (Anthropic) using Spring AI and tools to find flights, accommodations and sending mails.

Github Repository

Intermediate

Demonstrating how to build a multi-agent system using Akka and an LLM model. A workflow manages the user query process, handling the sequential steps of agent selection, plan creation, execution, and summarization.

Github Repository

Advanced

A customer registry with query capabilities

customer-registry-quickstart.zip

Intermediate

A funds transfer workflow between two wallets

Github Repository

Intermediate

A user registration service implemented as a Choreography Saga

Github Repository

Advanced

Akka Chess: a complete, resilient, automatically scalable, event-sourced chess game

Github Repository

Advanced

It is also possible to deploy a pre-built sample project in the Akka console, eliminating the need for local development.

Maven archetype

To create the build structure of a new service you can use the Maven archetype. From a command window, in the parent directory of the new service, run the following:

Linux or macOS

mvn archetype:generate \
  -DarchetypeGroupId=io.akka \
  -DarchetypeArtifactId=akka-javasdk-archetype \
  -DarchetypeVersion=3.3.2

Windows 10+

mvn archetype:generate ^
  -DarchetypeGroupId=io.akka ^
  -DarchetypeArtifactId=akka-javasdk-archetype ^
  -DarchetypeVersion=3.3.2

The Author your first Akka service starts from the Maven archetype and lets you implement a very simple service.