Updated README.md adding a How to Use section

README.md

@@ -78,6 +78,36 @@ 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 (i.e. `python -m uvicorn src.main:app --host 0.0.0.0 --port 7860 --reload`).
 
+## How to Use
+
+The API exposes a classification endpoint at `/classify` that accepts mushroom images and returns:
+
+- Predicted mushroom species
+- Edibility status (edible/poisonous)
+- Confidence score
+
+### API Endpoint
+
+`POST /classify`
+
+### Request Format
+
+```bash
+curl -X POST "http://<your-api-url>/classify" \
+  -H "Content-Type: multipart/form-data" \
+  -F "image_file=@path/to/mushroom.jpg"
+```
+
+### Example Response
+
+```bash
+{
+    "mushroom_type": "Pleurotus_ostreatus",
+    "toxicity_profile": "edible",
+    "confidence": 0.5491
+}
+```
+
 ## Deployment
 
 ### Deployment on Hugging Face Spaces
@@ -98,6 +128,8 @@ To deploy the project on Hugging Face Spaces, follow these steps:
   docker build -t musheff-api .
   ```
 
+````
+
 - Run a container based on the image:
 
   ```bash
@@ -139,3 +171,4 @@ For deployment on other cloud or live systems, consult the documentation provide
 ## Authors
 
 **Vlasios Dimitriadis** - _Initial work:_ [Musheff API](https://huggingface.co/spaces/blasisd/musheff-api)
+````