shopping-assistant: An AI-Powered Webshop Demo Exploring LLM Interactions
This repository profile is provided by osrepos.com, an open source repository discovery platform.

Summary
The `shopping-assistant` project is a Java-based webshop demo, 'Bizarre Bazaar', featuring an AI-powered shopping assistant. It explores various LLM interaction modes, from helpful guidance with state management and security guardrails to demonstrating prompt injection attacks and an unethical assistant. This educational application provides practical examples of integrating AI into e-commerce, highlighting both its potential and crucial security considerations.
Repository Information
Topics
Click on any tag to explore related repositories
Use at your own risk
OSRepos shares public repositories for knowledge and discovery only. Any installation, execution, configuration, or use of code from these repositories is the user's own responsibility. Always review the repository, source code, dependencies, licenses, and security implications before running or installing anything. OSRepos is not responsible for issues, damages, or losses resulting from third-party repositories.
Introduction
The shopping-assistant repository by LizeRaes presents "Bizarre Bazaar," a basic webshop demo powered by an AI shopping assistant. Developed in Java with Quarkus, this project serves as an educational tool to explore different facets of Large Language Model (LLM) integration in an e-commerce context. It demonstrates how AI can assist customers, manage conversational state, implement security measures against prompt injection, and even simulate unethical sales tactics, offering valuable insights into AI application development.
Installation
To get the shopping-assistant running, ensure you have Java 21 installed.
- Clone the repository:
git clone https://github.com/LizeRaes/shopping-assistant.git - Navigate into the project directory:
cd shopping-assistant - Make
mvnwexecutable if necessary:chmod +x mvnw - Launch the application in development mode:
./mvnw quarkus:devorquarkus dev(if Quarkus CLI is installed).
The application will typically be available at http://localhost:8080.
Examples
The shopping-assistant offers a rich set of examples, each demonstrating a specific aspect of AI assistant behavior and security. Here's a breakdown of the main modes:
1. Helpful Assistant with No State
- What it is: A single LLM handles all step transitions and has access to all tools.
- Demonstrates: High-quality LLMs can support easy workflows without explicit state management, though behavior can be unpredictable.
- Access:
http://localhost:8080/helpful-assistant-no-state.html
2. Helpful Assistant with State
- What it is: Different AI services are lined up in a state machine with a programmatically decided flow.
- Demonstrates: How to manage state predictably and limit responsibilities/tool access for different AI services.
- Access:
http://localhost:8080/helpful-assistant.html
3. Helpful Assistant with Human Confirmation
- What it is: The state machine from the previous version, but requires user confirmation before placing an order.
- Demonstrates: How to incorporate a human-in-the-loop for critical decisions, costly procedures, or sensitive actions.
- Access:
http://localhost:8080/helpful-assistant-with-confirmation.html
4. Helpful Assistant with Input Sanitization (Guardrails)
- What it is: Adds input sanitization to protect against prompt and SQL injection.
- Demonstrates: Implementing guardrails to secure your system from malicious inputs.
- Launch:
quarkus dev -Dguarded=true - Access:
http://localhost:8080/helpful-assistant-with-confirmation.html
5. Helpful Assistant Getting Hacked by LLM
- What it is: A simulated "hacker" LLM attempts to breach the system.
- Demonstrates: The importance of robust security measures, as AI can also be used for attacks.
- Launch:
quarkus dev -Dhacked=true - Access:
http://localhost:8080/helpful-assistant-with-confirmation.html
6. Helpful Assistant Interacting with an Uncensored Model
- What it is: Similar to the hacker demo, but with an uncensored model attempting to buy illicit items.
- Demonstrates: The behavior of uncensored models, primarily for fun and demonstration.
- Launch:
quarkus dev -Dshouting=true - Access:
http://localhost:8080/helpful-assistant-with-confirmation.html
7. Unethical Capitalist Assistant
- What it is: A helpful assistant that tries to maximize sales by tracking user profiles, offering more expensive products, and creating tailored descriptions.
- Demonstrates: Interaction between two AI agents and the potential for AI to influence purchasing decisions.
- Access:
http://localhost:8080/unethical-assistant.html
Why use it
This repository is an excellent resource for developers and AI enthusiasts interested in practical LLM applications. It provides hands-on examples for:
- Integrating LLMs into web applications using Java and Quarkus.
- Managing conversational state in AI assistants.
- Implementing security guardrails against prompt injection and other vulnerabilities.
- Understanding the ethical implications and potential for AI misuse.
- Exploring agent-to-agent interaction and personalized user experiences.
It's a valuable educational tool for anyone looking to build robust and secure AI-powered systems.
Links
- GitHub Repository: LizeRaes/shopping-assistant
Related repositories
Similar repositories that may be relevant next.

CompreFace: Free and Open-Source Face Recognition System with REST API
April 12, 2026
CompreFace is a leading free and open-source face recognition system that offers a robust REST API for various facial analysis tasks. It can be easily integrated into any system without requiring prior machine learning expertise, thanks to its Docker-based deployment. This powerful solution supports face recognition, detection, verification, and more, leveraging state-of-the-art methods like FaceNet and InsightFace.

java-sdk: The Official Java SDK for Model Context Protocol
February 11, 2026
The `java-sdk` is the official Java SDK for interacting with Model Context Protocol servers and clients. It provides a standardized interface for Java applications to communicate with AI models and tools, supporting both synchronous and asynchronous patterns. Developed in collaboration with Spring AI, it offers robust integration for building AI-powered applications.

Peergos: A P2P Secure File Storage, Social Network, and Application Protocol
October 21, 2025
Peergos is a peer-to-peer, secure platform designed for private file storage, social networking, and application hosting. It emphasizes user control over data, offering end-to-end encryption and fine-grained access control. Built on a decentralized architecture, Peergos aims to create a private web experience where users are protected from surveillance and data tracking.

quarkus-langchain4j-workshop: Build AI-Infused Apps with Quarkus and LangChain4j
October 11, 2025
Explore the `quarkus-langchain4j-workshop` to learn how to develop AI-infused applications using Quarkus and LangChain4j. This workshop provides a structured approach, guiding you through various steps to build powerful AI solutions. It's an excellent resource for developers looking to integrate large language models into their Quarkus projects.
Source repository
Open the original repository on GitHub.