From b65510650df4c7ded735ab2c0a24887aa2b7f988 Mon Sep 17 00:00:00 2001 From: Rodrigo Barbosa Date: Wed, 18 Feb 2026 14:15:29 +0000 Subject: [PATCH 1/2] new release number --- roboflow/__init__.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/roboflow/__init__.py b/roboflow/__init__.py index 6954ce23..40a2c245 100644 --- a/roboflow/__init__.py +++ b/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.13" +__version__ = "1.2.14" def check_key(api_key, model, notebook, num_retries=0): From 89c92868f2813f91db88fc923499c4d9ab1031ce Mon Sep 17 00:00:00 2001 From: Rodrigo Barbosa Date: Wed, 18 Feb 2026 16:29:43 +0000 Subject: [PATCH 2/2] update docs with search export --- CLI-COMMANDS.md | 47 +++++++++++++++++++++++++++++++++++++++++++++-- README.md | 22 ++++++++++++++++++++++ docs/index.md | 22 ++++++++++++++++++++++ 3 files changed, 89 insertions(+), 2 deletions(-) diff --git a/CLI-COMMANDS.md b/CLI-COMMANDS.md index 1e2372c2..771330ae 100644 --- a/CLI-COMMANDS.md +++ b/CLI-COMMANDS.md @@ -8,7 +8,7 @@ $ roboflow --help ``` ``` -usage: roboflow [-h] {login,download,upload,import,infer,project,workspace} ... +usage: roboflow [-h] {login,download,upload,import,infer,search-export,project,workspace} ... Welcome to the roboflow CLI: computer vision at your fingertips 🪄 @@ -16,12 +16,13 @@ options: -h, --help show this help message and exit subcommands: - {login,download,upload,import,infer,project,workspace} + {login,download,upload,import,infer,search-export,project,workspace} login Log in to Roboflow download Download a dataset version from your workspace or Roboflow Universe. upload Upload a single image to a dataset import Import a dataset from a local folder infer perform inference on an image + search-export Export search results as a dataset project project related commands. type 'roboflow project' to see detailed command help workspace workspace related commands. type 'roboflow workspace' to see detailed command help ``` @@ -245,3 +246,45 @@ roboflow infer -w roboflow-58fyf -m rock-paper-scissors-sxsw/11 ~/scissors.png "prediction_type": "ObjectDetectionModel" } ``` + +## Example: search and export a dataset + +Use Roboflow's search to query images across your workspace and export matching results as a dataset. This is useful when you want to create a dataset from specific search criteria (e.g. images with a certain class, tag, or other metadata). + +```bash +$ roboflow search-export --help +``` +``` +usage: roboflow search-export [-h] [-f FORMAT] [-w WORKSPACE] [-l LOCATION] [-d DATASET] [-g ANNOTATION_GROUP] [-n NAME] [--no-extract] query + +positional arguments: + query Search query (e.g. 'tag:annotate' or '*') + +options: + -h, --help show this help message and exit + -f FORMAT Annotation format (default: coco) + -w WORKSPACE Workspace url or id (uses default workspace if not specified) + -l LOCATION Local directory to save the export + -d DATASET Limit export to a specific dataset (project slug) + -g ANNOTATION_GROUP Limit export to a specific annotation group + -n NAME Optional name for the export + --no-extract Skip extraction, keep the zip file +``` + +Export all images tagged "annotate" in COCO format: + +```bash +$ roboflow search-export "tag:annotate" +``` + +Export images containing a specific class, limited to one dataset, in COCO format: + +```bash +$ roboflow search-export "class:person" -f coco -d my-dataset -l ~/exports/people +``` + +``` +Export started (id=abc123). Polling for completion... +Downloading search export to /Users/tony/exports/people: 100%|██████████| 5420/5420 [00:02<00:00, 2710.00it/s] +Search export extracted to /Users/tony/exports/people +``` diff --git a/README.md b/README.md index 24ac711e..22d04177 100644 --- a/README.md +++ b/README.md @@ -141,6 +141,28 @@ predictions = model.predict(img_url, hosted=True).json() print(predictions) ``` +### Search and Export + +Search for images across your workspace and export matching results as a ready-to-use dataset: + +```python +workspace = rf.workspace() + +# Export images matching a search query +workspace.search_export( + query="class:person", # search query (e.g. "tag:review", "class:dog", "*") + format="coco", # annotation format: coco, yolov8, yolov5, voc, etc. + dataset="my-project", # optional: limit to a specific project + location="./my-export", # optional: output directory +) +``` + +Or from the CLI: + +```bash +roboflow search-export "class:person" -f coco -d my-project -l ./my-export +``` + ## Library Structure The Roboflow Python library is structured using the same Workspace, Project, and Version ontology that you will see in the Roboflow application. diff --git a/docs/index.md b/docs/index.md index 542d11b2..04afb444 100644 --- a/docs/index.md +++ b/docs/index.md @@ -104,6 +104,28 @@ predictions = model.predict(img_url, hosted=True).json() print(predictions) ``` +### Search and Export + +Search for images across your workspace and export matching results as a ready-to-use dataset: + +```python +workspace = rf.workspace() + +# Export images matching a search query +workspace.search_export( + query="class:person", # search query (e.g. "tag:review", "class:dog", "*") + format="coco", # annotation format: coco, yolov8, yolov5, voc, etc. + dataset="my-project", # optional: limit to a specific project + location="./my-export", # optional: output directory +) +``` + +Or from the CLI: + +```bash +roboflow search-export "class:person" -f coco -d my-project -l ./my-export +``` + ## Library Structure The Roboflow Python library is structured using the same Workspace, Project, and Version ontology that you will see in the Roboflow application.