shopping-assistant: An AI-Powered Webshop Demo Exploring LLM Interactions

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.
At a glance
- Added to OSRepos
- October 11, 2025
- Last analyzed
- October 11, 2025
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
Source repository
Open the original repository on GitHub.
17 counted GitHub visits
Related repositories
Similar repositories that may be relevant next.

AstronRPA: Open-Source Enterprise RPA Suite with AI Agent Integration
September 15, 2026
AstronRPA is an open-source, enterprise-grade Robotic Process Automation (RPA) desktop application. It features a low-code, no-code visual designer for building automation workflows across desktop software and web pages. Deeply integrated with AI agents, AstronRPA empowers broader business automation scenarios for both individuals and enterprises.

awesome-java: Find Java Frameworks, Libraries, Tools, and Resources
July 12, 2026
A community-curated directory of Java frameworks, libraries, tools, and learning resources. Browse 839 projects across 81 categories to compare options for common development tasks.

opendataloader-pdf: Extract Structured Data and Accessibility Tags from PDFs
May 30, 2026
OpenDataLoader PDF parses digital, scanned, and tagged PDFs into structured formats for AI and document workflows. It also automates conversion of untagged PDFs into Tagged PDFs, with optional hybrid processing for complex documents.

CompreFace: Run Self-Hosted Face Recognition APIs
April 12, 2026
CompreFace is a Docker-based face analysis service with REST APIs for recognition, verification, detection, and related tasks. It suits teams that need to integrate face processing into applications while keeping deployment on their own infrastructure.