Updated README.md

README.md

@@ -55,16 +55,28 @@ To set up and run this project, ensure the following software and tools are inst
   pip install -r requirements.txt
   ```
 
+- **Docker (Optional)**: For containerized deployment. Install from [Docker's official site](https://docs.docker.com/get-docker/) and verify with:
+
+  ```bash
+  docker --version
+  ```
+
 ### Local Development and Testing
 
 To run the application locally for development and testing purposes, execute the following command in your terminal:
 
 ```bash
-python app.py
+uvicorn main:app --host 0.0.0.0 --port 7860 --reload
+```
+
+If it does not work, just try:
+
+```bash
+python -m uvicorn main:app --host 0.0.0.0 --port 7860 --reload
 ```
 
 > [!WARNING]
-> Ensure you are in the project's **src** directory before running the script or adapt running path.
+> Ensure you are in the project's **src** directory before running the script or adapt running path (i.e. `python -m uvicorn src.main:app --host 0.0.0.0 --port 7860 --reload`).
 
 ## Deployment
 
@@ -78,11 +90,25 @@ To deploy the project on Hugging Face Spaces, follow these steps:
 
 ### Docker-based Deployment
 
-For Docker-based Deployment:
+#### Locally
+
+- Build your docker image:
+
+  ```bash
+  docker build -t musheff-api .
+  ```
+
+- Run a container based on the image:
+
+  ```bash
+  docker run -it -p 7860:7860 musheff-api
+  ```
+
+#### On Hugging Face
 
 1. Follow the official [Docker Spaces Guide](https://huggingface.co/docs/hub/en/spaces-sdks-docker-first-demo) for container setup.
 2. Copy the available `Dockerfile` to your repository root or create your own.
-3. Configure settings requirements in `README.md` metadata (especially app_port):
+3. Configure settings requirements in `README.md` metadata (especially app_port if you need a different port to use):
 
 ```yaml
 ---