Docs updates and version bump

Author: digaobarbosa

CLI-COMMANDS.md

@@ -126,6 +126,26 @@ Uploading to existing project my-workspace/my-chess
 [UPLOADED] /home/jonny/tmp/chess/112_jpg.rf.1a6e7b87410fa3f787f10e82bd02b54e.jpg (7tWtAn573cKrefeg5pIO) / annotations = OK
 ```
 
+## Example: upload a single image
+
+Upload a single image to a project, optionally with annotations, tags, and metadata:
+
+```bash
+roboflow upload image.jpg -p my-project -s train
+```
+
+Upload with custom metadata (JSON string):
+
+```bash
+roboflow upload image.jpg -p my-project -M '{"camera_id":"cam001","location":"warehouse-3"}'
+```
+
+Upload with annotation and tags:
+
+```bash
+roboflow upload image.jpg -p my-project -a annotation.xml -t "outdoor,daytime" -s valid
+```
+
 ## Example: list workspaces
 List the workspaces you have access to
 

docs/index.md

@@ -126,6 +126,32 @@ Or from the CLI:
 roboflow search-export "class:person" -f coco -d my-project -l ./my-export
 ```
 
+### Upload with Metadata
+
+Attach custom key-value metadata to images during upload:
+
+```python
+project = workspace.project("my-project")
+
+# Upload a local image with metadata
+project.upload(
+    image_path="./image.jpg",
+    metadata={"camera_id": "cam001", "location": "warehouse-3"},
+)
+
+# Upload a hosted image with metadata
+project.upload(
+    image_path="https://example.com/image.jpg",
+    metadata={"camera_id": "cam002", "shift": "night"},
+)
+```
+
+Or from the CLI:
+
+```bash
+roboflow upload image.jpg -p my-project -M '{"camera_id":"cam001","location":"warehouse-3"}'
+```
+
 ## Library Structure
 
 The Roboflow Python library is structured using the same Workspace, Project, and Version ontology that you will see in the Roboflow application.

roboflow/__init__.py

@@ -15,7 +15,7 @@
 from roboflow.models import CLIPModel, GazeModel  # noqa: F401
 from roboflow.util.general import write_line
 
-__version__ = "1.2.14"
+__version__ = "1.2.15"
 
 
 def check_key(api_key, model, notebook, num_retries=0):