diff --git a/README.md b/README.md
index db2e957..af458ce 100644
--- a/README.md
+++ b/README.md
@@ -37,7 +37,7 @@ Users are expected to use this software responsibly and legally. If using a real
##### This is the fastest build you can get if you have a discrete NVIDIA GPU.
-###### These Pre-builts are perfect for non-technical users or those who don’t have time to, or can't manually install all the requirements. Just a heads-up: this is an open-source project, so you can also install it manually.
+###### These Pre-builts are perfect for non-technical users or those who don't have time to, or can't manually install all the requirements. Just a heads-up: this is an open-source project, so you can also install it manually.
## TLDR; Live Deepfake in just 3 Clicks
@@ -119,7 +119,8 @@ This is more likely to work on your computer but will be slower as it utilizes t
**2. Clone the Repository**
```bash
-https://github.com/hacksider/Deep-Live-Cam.git
+git clone https://github.com/hacksider/Deep-Live-Cam.git
+cd Deep-Live-Cam
```
**3. Download the Models**
@@ -133,14 +134,44 @@ Place these files in the "**models**" folder.
We highly recommend using a `venv` to avoid issues.
+For Windows:
```bash
+python -m venv venv
+venv\Scripts\activate
pip install -r requirements.txt
```
-**For macOS:** Install or upgrade the `python-tk` package:
+**For macOS:**
+
+Apple Silicon (M1/M2/M3) requires specific setup:
```bash
+# Install Python 3.10 (specific version is important)
+brew install python@3.10
+
+# Install tkinter package (required for the GUI)
brew install python-tk@3.10
+
+# Create and activate virtual environment with Python 3.10
+python3.10 -m venv venv
+source venv/bin/activate
+
+# Install dependencies
+pip install -r requirements.txt
+```
+
+** In case something goes wrong and you need to reinstall the virtual environment **
+
+```bash
+# Deactivate the virtual environment
+rm -rf venv
+
+# Reinstall the virtual environment
+python -m venv venv
+source venv/bin/activate
+
+# install the dependencies again
+pip install -r requirements.txt
```
**Run:** If you don't have a GPU, you can run Deep-Live-Cam using `python run.py`. Note that initial execution will download models (~300MB).
@@ -165,19 +196,39 @@ python run.py --execution-provider cuda
**CoreML Execution Provider (Apple Silicon)**
-1. Install dependencies:
+Apple Silicon (M1/M2/M3) specific installation:
+
+1. Make sure you've completed the macOS setup above using Python 3.10.
+2. Install dependencies:
```bash
pip uninstall onnxruntime onnxruntime-silicon
pip install onnxruntime-silicon==1.13.1
```
-2. Usage:
+3. Usage (important: specify Python 3.10):
```bash
-python run.py --execution-provider coreml
+python3.10 run.py --execution-provider coreml
```
+**Important Notes for macOS:**
+- You **must** use Python 3.10, not newer versions like 3.11 or 3.13
+- Always run with `python3.10` command not just `python` if you have multiple Python versions installed
+- If you get error about `_tkinter` missing, reinstall the tkinter package: `brew reinstall python-tk@3.10`
+- If you get model loading errors, check that your models are in the correct folder
+- If you encounter conflicts with other Python versions, consider uninstalling them:
+ ```bash
+ # List all installed Python versions
+ brew list | grep python
+
+ # Uninstall conflicting versions if needed
+ brew uninstall --ignore-dependencies python@3.11 python@3.13
+
+ # Keep only Python 3.10
+ brew cleanup
+ ```
+
**CoreML Execution Provider (Apple Legacy)**
1. Install dependencies:
@@ -222,7 +273,6 @@ pip install onnxruntime-openvino==1.15.0
```bash
python run.py --execution-provider openvino
```
-
## Usage
@@ -328,6 +378,4 @@ Looking for a CLI mode? Using the -s/--source argument will make the run program
-
-
-
+
\ No newline at end of file