Roboflow Python Package

Roboflow provides everything you need to build and deploy computer vision models. roboflow-python is the official Roboflow Python package. roboflow-python enables you to interact with models, datasets, and projects hosted on Roboflow.

With this Python package, you can:

  1. Create and manage projects;
  2. Upload images, annotations, and datasets to manage in Roboflow;
  3. Start training vision models on Roboflow;
  4. Run inference on models hosted on Roboflow, or Roboflow models self-hosted via Roboflow Inference, and more.

The Python package is documented on the official Roboflow documentation site. If you are developing a feature for this Python package, or need a full Python library reference, refer to the package developer documentation.

💻 Installation

You will need to have Python 3.8 or higher set up to use the Roboflow Python package.

Run the following command to install the Roboflow Python package:

pip install roboflow

For desktop features, use:

pip install "roboflow[desktop]"
Lightweight install (roboflow-slim)

If you only need vision events, workspace management, and the CLI (no image processing, inference, or training), install the lightweight package:

pip install roboflow-slim

This skips heavy dependencies like OpenCV, NumPy, Matplotlib, and Pillow, reducing install size from ~400MB to ~50MB. Useful for embedded devices, CI pipelines, and serverless environments.

Both packages share the same codebase and version. pip install roboflow includes everything.

Install from source

You can also install the Roboflow Python package from source using the following commands:

git clone https://github.com/roboflow-ai/roboflow-python.git
cd roboflow-python
python3 -m venv env
source env/bin/activate
pip install .
Command line tool

By installing roboflow python package you can use some of its functionality in the command line (without having to write python code). See CLI-COMMANDS.md

🚀 Getting Started

To use the Roboflow Python package, you first need to authenticate with your Roboflow account. You can do this by running the following command:

import roboflow
roboflow.login()
Authenticate with an API key

You can also authenticate with an API key by using the following code:

import roboflow

rf = roboflow.Roboflow(api_key="")

Learn how to retrieve your Roboflow API key.

Quickstart

Below are some common methods used with the Roboflow Python package, presented concisely for reference. For a full library reference, refer to the Roboflow API reference documentation.

import roboflow

# Pass API key or use roboflow.login()
rf = roboflow.Roboflow(api_key="MY_API_KEY")

workspace = rf.workspace()

# creating object detection model that will detect flowers
project = workspace.create_project(
    project_name="Flower detector",
    project_type="object-detection", # Or "classification", "instance-segmentation", "semantic-segmentation"
    project_license="MIT", # "private" for private projects, only available for paid customers
    annotation="flowers" # If you plan to annotate lillys, sunflowers, etc.
)

# upload a dataset
workspace.upload_dataset(
    dataset_path="./dataset/",
    num_workers=10,
    dataset_format="yolov8", # supports yolov8, yolov5, and Pascal VOC
    project_license="MIT",
    project_type="object-detection"
)

version = project.version("VERSION_NUMBER")

# upload model weights - yolov10
version.deploy(model_type="yolov10", model_path=f”{HOME}/runs/detect/train/”, filename="weights.pt")

# run inference (a version may own several trained models; models() returns all of them)
model = version.models()[0]

img_url = "https://media.roboflow.com/quickstart/aerial_drone.jpeg"

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:

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:

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.

import roboflow

roboflow.login()

rf = roboflow.Roboflow()

workspace = rf.workspace("WORKSPACE_URL")
project = workspace.project("PROJECT_URL")
version = project.version("VERSION_NUMBER")

The workspace, project, and version parameters are the same as those you will find in the URL addresses at app.roboflow.com and universe.roboflow.com.

Within the workspace object you can perform actions like making a new project, listing your projects, or performing active learning where you are using predictions from one project's model to upload images to a new project.

Within the project object, you can retrieve metadata about the project, list versions, generate a new dataset version with preprocessing and augmentation settings, train a model in your project, and upload images and annotations to your project.

Within the version object, you can download the dataset version in any model format, train the version on Roboflow, and deploy your own external model to Roboflow.

🏆 Contributing

We would love your input on how we can improve the Roboflow Python package! Please see our contributing guide to get started. Thank you 🙏 to all our contributors!


Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

Owner

PyPI data
Data sourced directly from PyPI's database.

4 maintainers

PyPI data
Data sourced directly from PyPI's database.
Avatar for robolake from gravatar.com robolake Avatar for sachin-roboflow from gravatar.com sachin-roboflow Avatar for SkalskiP from gravatar.com SkalskiP
+1 more Avatar for tony_roboflow from gravatar.com tony_roboflow

Credits

Author: Roboflow

License

Apache Software License

Requires

Python >=3.10

Provides Extra

desktop dev

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

roboflow-1.4.2.tar.gz (276.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

roboflow-1.4.2-py3-none-any.whl (302.8 kB view details)

Uploaded Python 3

File details

Details for the file roboflow-1.4.2.tar.gz.

File metadata

  • Download URL: roboflow-1.4.2.tar.gz
  • Upload date:
  • Size: 276.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for roboflow-1.4.2.tar.gz
Algorithm Hash digest
SHA256 c6b6631bd1bb64671e4080c84da510557157a62b289fc4263c3ce95be05c87e5
MD5 c231fdd5a219a54b8af1ff2323967e9b
BLAKE2b-256 02e843f36a949636ed2283ca54df9ec47c50b1ef1ee1acb494b34ef039a69eec

See more details on using hashes here.

Provenance

The following attestation bundles were made for roboflow-1.4.2.tar.gz:

Publisher: publish.yml on roboflow/roboflow-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file roboflow-1.4.2-py3-none-any.whl.

File metadata

  • Download URL: roboflow-1.4.2-py3-none-any.whl
  • Upload date:
  • Size: 302.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for roboflow-1.4.2-py3-none-any.whl
Algorithm Hash digest
SHA256 447b198aef9d628d8e4e1323f85b5c3d0bfa124f5099c8746697cf34b85e47c7
MD5 e91656e5227d97ce198f17d36433a4b7
BLAKE2b-256 9db762136d216e7e91546f419e45cf5d9507c8a989f384d7743ad1574cdc640e

See more details on using hashes here.

Provenance

The following attestation bundles were made for roboflow-1.4.2-py3-none-any.whl:

Publisher: publish.yml on roboflow/roboflow-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

1.4.2 This release

2 files

1.4.1

2 files

1.4.0

2 files

1.3.13

2 files

1.3.12

2 files

1.3.11

2 files

1.3.10

2 files

1.3.9

2 files

1.3.8

2 files

1.3.7

2 files

1.3.6

2 files

1.3.5

2 files

1.3.3

2 files

1.3.2

2 files

1.3.1

2 files

1.2.16

2 files

1.2.15

2 files

1.2.14

2 files

1.2.13

2 files

1.2.12

2 files

1.2.11

2 files

1.2.10

2 files

1.2.9

2 files

1.2.8

2 files

1.2.7

2 files

1.2.6

2 files

1.2.5

2 files

1.2.4

2 files

1.2.3

2 files

1.2.2

2 files

1.2.1

2 files

1.2.0

2 files

1.1.67

2 files

1.1.66

2 files

1.1.65

2 files

1.1.64

2 files

1.1.63

2 files

1.1.62

2 files

1.1.61

2 files

1.1.60

2 files

1.1.58

2 files

1.1.57

2 files

1.1.56

2 files

1.1.55

2 files

1.1.54

2 files

1.1.53

2 files

1.1.51

2 files

1.1.50

2 files

1.1.49

2 files

1.1.48

2 files

1.1.47

2 files

1.1.46

2 files

1.1.45

2 files

1.1.44

2 files

1.1.43

2 files

1.1.42

2 files

1.1.41

2 files

1.1.40

2 files

1.1.39

2 files

1.1.38

2 files

1.1.37

2 files

1.1.36

2 files

1.1.35

2 files

1.1.34

2 files

1.1.33

2 files

1.1.32

2 files

1.1.31

2 files

1.1.30

2 files

1.1.29

2 files

1.1.28

2 files

1.1.27

2 files

1.1.26

2 files

1.1.25

2 files

1.1.24

2 files

1.1.23

2 files

1.1.22

2 files

1.1.21

2 files

1.1.20

2 files

1.1.19

2 files

1.1.18

2 files

1.1.17

2 files

1.1.16

2 files

1.1.15

2 files

1.1.14

2 files

1.1.13

2 files

1.1.12

2 files

1.1.11

3 files

1.1.10

2 files

1.1.9

2 files

1.1.8

2 files

1.1.7

2 files

1.1.6

2 files

1.1.5

2 files

1.1.4

2 files

1.1.3

2 files

1.1.2

2 files

1.1.1

2 files

1.1.0

2 files

1.0.9

2 files

1.0.8

2 files

1.0.5

2 files

1.0.4

2 files

1.0.3

2 files

1.0.2

2 files

1.0.1

2 files

1.0.0

2 files

0.2.34

2 files

0.2.32

2 files

0.2.31

2 files

0.2.30

2 files

0.2.29

2 files

0.2.28

2 files

0.2.27

2 files

0.2.26

2 files

0.2.25

2 files

0.2.24

2 files

0.2.23

2 files

0.2.22

2 files

0.2.21

2 files

0.2.20

2 files

0.2.19

2 files

0.2.18

2 files

0.2.17

2 files

0.2.16

2 files

0.2.15

2 files

0.2.14

2 files

0.2.13

2 files

Yanked

0.2.12

2 files

Yanked reason: Major regression

0.2.11

2 files

0.2.10

2 files

0.2.9

2 files

0.2.8

2 files

0.2.7

2 files

0.2.6

2 files

0.2.5

2 files

0.2.4

2 files

0.2.2

2 files

0.2.1

2 files

0.2.0

2 files

0.1.9

2 files

0.1.8

2 files

0.1.7

2 files

0.1.6

2 files

0.1.5

2 files

0.1.4

2 files

0.1.3

2 files

0.1.2

2 files

0.1.1

2 files

0.0.2

1 file

0.0.1

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page