diff --git a/src/python/README b/src/python/README.md
similarity index 100%
rename from src/python/README
rename to src/python/README.md
diff --git a/src/python/run_diff3_analysis.py b/src/python/bulk_diff3_analysis.py
similarity index 98%
rename from src/python/run_diff3_analysis.py
rename to src/python/bulk_diff3_analysis.py
index bdb1fc1c58..10d2232d4d 100644
--- a/src/python/run_diff3_analysis.py
+++ b/src/python/bulk_diff3_analysis.py
@@ -1,4 +1,5 @@
 """Recreates merges on selection of algorithms with a selection of commits.
+See readme for details on shell scripts to run these methods.
 """
 
 import sys
diff --git a/src/python/diff3_analysis.py b/src/python/diff3_analysis.py
index 5b120a5ecc..85ff06d133 100644
--- a/src/python/diff3_analysis.py
+++ b/src/python/diff3_analysis.py
@@ -1,4 +1,5 @@
 """Runs a merge and uses diff3 to compare it to the base and final branch of a given repo.
+See readme for details on shell scripts to run these methods.
 """
 
 import sys
diff --git a/src/python/requirements.txt b/src/python/requirements.txt
new file mode 100644
index 0000000000..d9203ffc79
--- /dev/null
+++ b/src/python/requirements.txt
@@ -0,0 +1,9 @@
+fasteners==0.14.1
+lxml==5.1.0
+matplotlib==3.8.3
+numpy==1.26.4
+pandas==2.2.1
+prettytable==3.10.0
+psutil==5.9.8
+seaborn==0.13.2
+tqdm==4.66.2