commit 03ef39cb0889c0b4bb0c7395a246d82872152510
Author: Sławek Koszewski <slawek@koszewscy.waw.pl>
Date:   Thu Aug 14 15:50:41 2025 +0000

    Initialized the repository. Added the README.md file.

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..03fb145
--- /dev/null
+++ b/README.md
@@ -0,0 +1,16 @@
+## Azure Image Chooser
+
+Azure Image Chooser is a [Streamlit](https://streamlit.io) application that allows users to select Azure VM images from the Azure Marketplace.
+
+It is in its preliminary version and is subject to development and change. It is provided here for you convenience and may not include all features or functionality of the final product.
+
+Azure Image Chooser is written in Python and requires Python interpreter. At the time of writing this, Python 3.13 is the latest. Execute the following commands to run the app:
+
+```shell
+python3 -m venv .venv
+.venv/bin/python -m pip install pip --upgrade
+.venv/bin/pip install streamlit azure-identity azure-mgmt-compute
+.venv/bin/streamlit run image-chooser.py
+```
+
+You have to be authenticated in Azure CLI. The app will block terminal and start a web server. Follow the instructions in the terminal to access the app.