README.md

Java AI - AI Shop

This is a simple AI Shop application that demonstrates how to use Azure OpenAI with Java to create a sample second hand shop. It uses the multi-modal capabilities of the OpenAI API to generate a description of the product based on an image. Instead of filling out a form, the users can simply upload an image of the product they want to sell and the AI will generate all the necessary information and fill the form for them.

The functional architecture of the application is as follows:

• src/ai-shop-ui: The user interface of the application. It is a simple React application that allows the user to upload an image and see the generated information in a form.
• src/api-gateway: The API Gateway of the application. It is a Spring Boot application that orchestrates the calls to the other services. It uses Spring Cloud Eureka Server for service discovery.
• src/eureka-server: The Eureka Server of the application. It is simple Eureka Server that is only required for local development.
• src/ai-image-processing-service: The AI Image Processing Service of the application. It is a Spring Boot application that uses Spring AI to generate the product information based on the image.
• src/blob-storage-service: The Blob Storage Service of the application. It is a Spring Boot application that uses Spring Cloud Azure to store the images in Azure Blob Storage. It also provide the generation of the image URL with a SAS token for the ai-image-processing-service.
• src/item-category-service: The Item Category Service of the application. It is a Spring Boot application that provides the categories of the items that can be sold in the shop. It uses Spring Data JPA to store the categories in a H2 database. It is infused with AI and uses LangChain4j to generate the categories based on the product description.
• src/java-ai-common: A common module that is used by all the services. It contains the common DTOs.

Prerequisites

Easiest way to start is to Fork and open the repository in a GitHub Codespace as it contains all the prerequisites.

If you develop locally, you need to have the following installed:

• Java 17+
• Azure CLI
• Azure Developer CLI (azd)
• Docker or Podman

Run locally

To run the AI Shop locally, you need first to build the common module and then start the services. Follow the instructions below in the order they are presented:

1. Build the common module
2. Start the Eureka Server
3. Start the Blob Storage Service
4. Start the AI Image Processing Service
5. Start the Item Category Service
6. Start the API Gateway
7. Start the AI Shop UI

Deploy to Azure

The following resources will be created as represented in the diagram below:

• Resource Group
• Azure Container Registry
• Azure Container Apps Environment
  • Eureka Server for Spring Component
  • Admin for Spring Component
• Azure Blob Storage Account
• User-assigned Managed Identity to pull the images from the Azure Container Registry
• Azure OpenAI
• Azure Container Apps with Java Runtime
• Azure Logs Analytics Workspace for monitoring

Quick start

To deploy the AI Shop to Azure, you need only to run the azd up command. The Azure Developer CLI (azd) will create all the necessary resources in Azure and deploy the services to Azure Container Apps.

Trademarks

This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft's Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies.