https://github.com/Azure-Samples/eShopLite
eShopLite is a set of reference .NET applications implementing an eCommerce site with features like Semantic Search, MCP, Reasoning models and more.
https://github.com/Azure-Samples/eShopLite
aspire awesome-azd awesome-mcp azd azd-templates azure-openai chromadb deepseek-r1 embeddings eshoplite managed-identity mcp mcp-client mcp-server rag semantic-search
Last synced: 12 months ago
JSON representation
eShopLite is a set of reference .NET applications implementing an eCommerce site with features like Semantic Search, MCP, Reasoning models and more.
- Host: GitHub
- URL: https://github.com/Azure-Samples/eShopLite
- Owner: Azure-Samples
- License: mit
- Created: 2025-04-19T15:32:22.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-04T20:37:00.000Z (12 months ago)
- Last Synced: 2025-06-05T02:15:39.348Z (12 months ago)
- Topics: aspire, awesome-azd, awesome-mcp, azd, azd-templates, azure-openai, chromadb, deepseek-r1, embeddings, eshoplite, managed-identity, mcp, mcp-client, mcp-server, rag, semantic-search
- Language: C#
- Homepage: https://aka.ms/eshoplite/repo
- Size: 10 MB
- Stars: 45
- Watchers: 11
- Forks: 20
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Code of conduct: .github/CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-dotnet-mcp - eShopLite - eShopLite is a set of reference .NET applications implementing an eCommerce site with features like Semantic Search, MCP, Reasoning models and mo (Servers / DotNET)
README
[](https://github.com/azure-samples/eshoplite/blob/main/LICENSE)
[](https://github.com/azure-samples/eshoplite/graphs/contributors/)
[](https://github.com/azure-samples/eshoplite/issues/)
[](https://github.com/azure-samples/eshoplite/pulls/)
[](http://makeapullrequest.com)
[](https://github.com/azure-samples/eshoplite/watchers/)
[](https://github.com/azure-samples/eshoplite/network/)
[](https://github.com/azure-samples/eshoplite/stargazers/)
[](https://aka.ms/ai-discord/dotnet)
[](https://aka.ms/ai-discussions/dotnet)
# eShopLite
**eShopLite** is a set of reference .NET applications implementing an eCommerce site with features like Semantic Search, Model Context Protocol (MCP), Reasoning models, vector databases, and more.
> - ☁️ **All scenarios in this repository use the latest version of .NET and leverage .NET Aspire to orchestrate the entire solution.**
> - 🌟 Don't forget to **[star (🌟) this repo](https://docs.github.com/en/get-started/exploring-projects-on-github/saving-repositories-with-stars)** to find it easier later.
> - ➡️ Get your own copy by **[Forking this repo](https://github.com/azure-samples/eshoplite/fork)** and find it next in your own repositories.
> - ❓ **Have a question?** Besides creating [issues](https://github.com/azure-samples/eshoplite/issues) or [pull requests](https://github.com/azure-samples/eshoplite/pulls), the best option for questions is to join the [Azure AI Discord channel](https://discord.com/invite/ByRwuEEgH4), where a team of AI experts can help you.
## Features
This project framework provides the following features:
* Modern .NET application architecture with .NET Aspire
* Various search capabilities (keyword search, semantic search)
* Integration with multiple AI models (GPT-4o, DeepSeek-R1, etc.)
* Vector database implementations (In Memory, Azure AI Search, Chroma DB and others)
* Real-time audio capabilities
* Model Context Protocol (MCP) server and client implementation
## eShopLite Scenarios
The project includes several scenarios demonstrating different capabilities:
| Scenario | Description | Key Technologies |
|----------|-------------|-----------------|
| [01 - Semantic Search](./scenarios/01-SemanticSearch/) | A reference .NET application implementing an eCommerce site with Search features using Keyword Search and Semantic Search. | .NET Aspire, OpenAI GPT-4o-mini, In-memory Vector DB |
| [02 - Azure AI Search](./scenarios/02-AzureAISearch/) | Implements an eCommerce site with Keyword Search using SQL queries and Semantic Search with Vector Database and Azure AI Search. | Azure AI Search, OpenAI Embeddings, SQL Server |
| [03 - Realtime Audio](./scenarios/03-RealtimeAudio/) | Extends the eCommerce site with advanced search features and real-time audio capabilities powered by the GPT-4o Realtime Audio API. | GPT-4o Realtime Audio API, Audio in Blazor, .NET Aspire |
| [04 - Chroma DB](./scenarios/04-chromadb/) | Implements semantic search functionality using Chroma DB, an open-source database designed for AI applications. | Chroma DB, OpenAI Embeddings, .NET SDK |
| [05 - DeepSeek-R1](./scenarios/05-deepseek/) | Demonstrates integration of the DeepSeek-R1 model for enhanced semantic understanding and search capabilities. | DeepSeek-R1, .NET Aspire, Vector Embeddings |
| [06 - Model Context Protocol (MCP)](./scenarios/06-mcp/) | Implements the Model Context Protocol (MCP) for advanced AI interactions with MCP Servers and MCP Clients. | Model Context Protocol, Function Calling, SSE Events |
| [07 - Agents Concurrent](./scenarios/07-AgentsConcurrent/) | Demonstrates concurrent agent orchestration and advanced AI agent collaboration patterns. | .NET Aspire, Multi-Agent Systems, Orchestration |
## Getting Started
### Prerequisites
- [.NET 9](https://dotnet.microsoft.com/download/dotnet/9.0)
- [Docker Desktop](https://www.docker.com/products/docker-desktop/) or [Podman](https://podman.io/)
- [Azure Developer CLI (azd)](https://aka.ms/install-azd) (for Azure deployment)
- [Git](https://git-scm.com/downloads)
### Installation
1. Clone the repository:
```bash
git clone https://github.com/Azure-Samples/eShopLite.git
```
1. Navigate to the scenario directory of interest:
```bash
cd eShopLite/scenarios/[scenario-folder]
```
1. Login to Azure:
```shell
azd auth login
```
1. Provision and deploy all the resources:
```shell
azd up
```
It will prompt you to provide an `azd` environment name (like "eShopLite"), select a subscription from your Azure account, and select a [location where the necessary models, like gpt-4o-mini and ADA-002 are available](https://azure.microsoft.com/explore/global-infrastructure/products-by-region/?products=cognitive-services®ions=all), a sample region can be "eastus2".
### Quickstart
1. Navigate to a specific scenario folder (e.g., `scenarios/01-SemanticSearch/`)
2. Follow the README instructions in that scenario folder
3. Run the solution using `dotnet run` in the appropriate host project folder
## Demo
To run the demo, follow these steps:
1. Navigate to the specific scenario folder
2. Follow the "Run the solution" instructions in that scenario's README
3. Access the application via the URLs provided in the console output
## Sample Application
This is the eShopLite Aplication running, performing a **Keyword Search**:
This is the eShopLite Aplication running, performing a **Semantic Search**:
This is the eShopLite Application running the **Realtime Audio** feature:
This is the eShopLite Application using the **DeepSeek-R1 Reasoning Model**:
The Aspire Dashboard to check the running services:
The Azure Resource Group with all the deployed services:
## Resources
- [Generative AI for Beginners .NET](https://aka.ms/genainnet)
- [.NET Aspire Documentation](https://learn.microsoft.com/dotnet/aspire/)
- [Azure OpenAI Service Documentation](https://learn.microsoft.com/azure/ai-services/openai/)