diff --git a/bazarr/README.md b/bazarr/README.md
new file mode 100644
index 000000000..ec2efcc57
--- /dev/null
+++ b/bazarr/README.md
@@ -0,0 +1,20 @@
+
+NOTE: must use python 3.12
+
+If your on mac you may need to change the `python` below to `python3.12`
+
+# Create a virtual environment
+
+python -m venv venv
+
+# Activate the virtual environment
+
+source venv/bin/activate
+
+# Install the dependencies
+
+pip install -r requirements.txt
+
+# Run
+
+python bazarr/main.py --no-update