Roboflow makes managing, preprocessing, augmenting, and versioning datasets for computer vision seamless.

Overview

Roboflow Python Library


roboflow logo

WebsiteDocsBlogTwitterLinkedinUniverse

Roboflow makes managing, preprocessing, augmenting, and versioning datasets for computer vision seamless. This is the official Roboflow python package that interfaces with the Roboflow API. Key features of Roboflow:

Installation:

To install this package, please use Python 3.6 or higher. We provide three different ways to install the Roboflow package to use within your own projects.

Install from PyPi (Recommended):

pip install roboflow

Install from Source:

git clone https://github.com/roboflow-ai/roboflow-python.git
cd roboflow-python
python3 -m venv
source venv/bin/activate 
pip3 install -r requirements.txt

Quickstart

import roboflow

# Instantiate Roboflow object with your API key
rf = Roboflow(api_key=YOUR_API_KEY_HERE)

# List all projects for your workspace
workspace = rf.workspace()

# Load a certain project, workspace url is optional
project = rf.project("PROJECT_ID")

# List all versions of a specific project
project.versions()

# Upload image to dataset
project.upload("UPLOAD_IMAGE.jpg")

# Retrieve the model of a specific project
project.version("1").model

# predict on a local image
prediction = model.predict("YOUR_IMAGE.jpg")

# Predict on a hosted image
prediction = model.predict("YOUR_IMAGE.jpg", hosted=True)

# Plot the prediction
prediction.plot()

# Convert predictions to JSON
prediction.json()

# Save the prediction as an image
prediction.save(output_path='predictions.jpg')
Issues
  • full refactor of pip package

    full refactor of pip package

    *this is an initial PR, let me know of any changes that need to be made.

    • modified structure of package to be initialized with Roboflow() object
    • added version objects to detect versioning
    • added retrieval for workspaces
    • modified all routes to reflect no workspace prefix in front of project name
    • changed tests to reflect changes
    • changed Project() object to have list of Version() objects
    opened by Palashio 5
  • Roboflow YOLOv5 Custom Training Notebook

    Roboflow YOLOv5 Custom Training Notebook

    https://colab.research.google.com/drive/1SQ_nlPiovGTGc2IfWmf9EIyNxCne4f3U

    Threading here for feedback

    opened by Jacobsolawetz 3
  • No module named 'dotenv'

    No module named 'dotenv'

    You can replicate on colab !pip install roboflow import roboflow

    Should we have an install_requires for dependencies in setup.py?

    opened by Jacobsolawetz 1
  • Wrong filename / missing images produces cryptic openCV error message

    Wrong filename / missing images produces cryptic openCV error message

    I tried uploading an image using the pip package and accidentally misspelled the filename. When an image doesn't exists I get the following error when e.g. trying to call: project.upload("/Users/hansent/Desktop/original.jpeg")

    Error:

    Traceback (most recent call last):
      File "/Users/hansent/Desktop/upload.py", line 16, in <module>
        project.upload("/Users/hansent/Desktop/original.jpg")
      File "/usr/local/lib/python3.9/site-packages/roboflow/core/project.py", line 143, in upload
        response = self.__image_upload(image_path, hosted_image=hosted_image, split=split)
      File "/usr/local/lib/python3.9/site-packages/roboflow/core/project.py", line 89, in __image_upload
        image = cv2.cvtColor(img, cv2.COLOR_BGR2RGB)
    cv2.error: OpenCV(4.5.3) /private/var/folders/24/8k48jl6d249_n_qfxwsl6xvm0000gn/T/pip-req-build-vy_omupv/opencv/modules/imgproc/src/color.cpp:182: error: (-215:Assertion failed) !_src.empty() in function 'cvtColor'
    
    

    It would be nice if the library checked for the existence of the file and gave a nicer error message instead.

    opened by hansent 1
  • fixes bug #10

    fixes bug #10

    null

    opened by Palashio 1
  • Documentation Review

    Documentation Review

    null

    opened by Jacobsolawetz 1
  • final changes to pip package

    final changes to pip package

    • added fields to version() and workspace() classes.
    • changed .project() method to return right version of the class
    • other smaller changes
    opened by Palashio 0
  • setup

    setup

    • added setup.py
    • removed setup.cfg
    opened by Palashio 0
  • Create setup.py

    Create setup.py

    null

    opened by Palashio 0
  • pip package changes

    pip package changes

    • modifications to setup.py for the pip package that's live
    opened by Palashio 0
  • Documentation Out of Date

    Documentation Out of Date

    A user reports that our documentation has my_projects = rf.projects() but this causes an error. Likely because it needs to come from the workspace vs the top level Roboflow object. The docs likely need to be updated.

    Other docs that may be out of date:

    • rf.project("project-id") is not clear that you need to also include the workspace id.
    • all_version=project.versions() may need to be my_projects.list_versions()

    We should go through the docs & dogfood them to ensure they work with the current version of the roboflow pip package.

    documentation 
    opened by yeldarby 0
  • idna version error

    idna version error

    A user reported getting an idna version error (which may be a conflict with their version of requests). We should look at whether we need to restrict these version numbers in the requirements.txt.

    opened by yeldarby 0
  • Notebook onboarding and revamps

    Notebook onboarding and revamps

    null

    opened by Jacobsolawetz 0
Releases(v0.1.2)
  • v0.1.2(Sep 15, 2021)

    First official release of roboflow pip package! More information can be found on our announcement blog post.

    • access information about your projects, workspaces, and versions through python.
    • perform inference on local, or hosted images
    • analyze, and save inference
    Source code(tar.gz)
    Source code(zip)
Kornia is a open source differentiable computer vision library for PyTorch.

Open Source Differentiable Computer Vision Library

kornia 5.1k Oct 22, 2021
Aloception is a set of package for computer vision: aloscene, alodataset, alonet.

Aloception is a set of package for computer vision: aloscene, alodataset, alonet.

Visual Behavior 65 Oct 21, 2021
Camelot: PDF Table Extraction for Humans

Camelot: PDF Table Extraction for Humans Camelot is a Python library that makes it easy for anyone to extract tables from PDF files! Note: You can als

Atlan Technologies Pvt Ltd 3.1k Oct 22, 2021
Open Source Differentiable Computer Vision Library for PyTorch

Kornia is a differentiable computer vision library for PyTorch. It consists of a set of routines and differentiable modules to solve generic computer

kornia 5.1k Oct 23, 2021
A collection of resources (including the papers and datasets) of OCR (Optical Character Recognition).

OCR Resources This repository contains a collection of resources (including the papers and datasets) of OCR (Optical Character Recognition). Contents

Zuming Huang 343 Sep 25, 2021
Image augmentation library in Python for machine learning.

Augmentor is an image augmentation library in Python for machine learning. It aims to be a standalone library that is platform and framework independe

Marcus D. Bloice 4.5k Oct 15, 2021
Links to awesome OCR projects

Awesome OCR This list contains links to great software tools and libraries and literature related to Optical Character Recognition (OCR). Contribution

Konstantin Baierer 1.9k Oct 20, 2021
Scene text detection and recognition based on Extremal Region(ER)

Scene text recognition A real-time scene text recognition algorithm. Our system is able to recognize text in unconstrain background. This algorithm is

HSIEH, YI CHIA 150 Aug 31, 2021
pulse2percept: A Python-based simulation framework for bionic vision

pulse2percept: A Python-based simulation framework for bionic vision Retinal degenerative diseases such as retinitis pigmentosa and macular degenerati

null 55 Oct 15, 2021
Code for the AAAI 2018 publication "SEE: Towards Semi-Supervised End-to-End Scene Text Recognition"

SEE: Towards Semi-Supervised End-to-End Scene Text Recognition Code for the AAAI 2018 publication "SEE: Towards Semi-Supervised End-to-End Scene Text

Christian Bartz 555 Sep 30, 2021
Fast image augmentation library and easy to use wrapper around other libraries. Documentation: https://albumentations.ai/docs/ Paper about library: https://www.mdpi.com/2078-2489/11/2/125

Albumentations Albumentations is a Python library for image augmentation. Image augmentation is used in deep learning and computer vision tasks to inc

null 9k Oct 22, 2021
A general list of resources to image text localization and recognition 场景文本位置感知与识别的论文资源与实现合集 シーンテキストの位置認識と識別のための論文リソースの要約

Scene Text Localization & Recognition Resources Read this institute-wise: English, 简体中文. Read this year-wise: English, 简体中文. Tags: [STL] (Scene Text L

Karl Lok (Zhaokai Luo) 835 Oct 20, 2021
📷 This repository is focused on having various feature implementation of OpenCV in Python.

?? This repository is focused on having various feature implementation of OpenCV in Python. The aim is to have a minimal implementation of all OpenCV features together, under one roof.

Aditya Kumar Gupta 115 Oct 19, 2021
Open Source Computer Vision Library

OpenCV: Open Source Computer Vision Library Resources Homepage: https://opencv.org Courses: https://opencv.org/courses Docs: https://docs.opencv.org/m

OpenCV 57.4k Oct 23, 2021
Introduction to Augmented Reality (AR) with Python 3 and OpenCV 4.2.

Introduction to Augmented Reality (AR) with Python 3 and OpenCV 4.2.

fernanda rodríguez 44 Oct 4, 2021
The Open Source Framework for Machine Vision

SimpleCV Quick Links: About Installation [Docker] (#docker) Ubuntu Virtual Environment Arch Linux Fedora MacOS Windows Raspberry Pi SimpleCV Shell Vid

Sight Machine 2.5k Oct 13, 2021
Code for the paper STN-OCR: A single Neural Network for Text Detection and Text Recognition

STN-OCR: A single Neural Network for Text Detection and Text Recognition This repository contains the code for the paper: STN-OCR: A single Neural Net

Christian Bartz 486 Sep 29, 2021
Text recognition (optical character recognition) with deep learning methods.

What Is Wrong With Scene Text Recognition Model Comparisons? Dataset and Model Analysis | paper | training and evaluation data | failure cases and cle

Clova AI Research 2.6k Oct 20, 2021
Code release for our paper, "SimNet: Enabling Robust Unknown Object Manipulation from Pure Synthetic Data via Stereo"

SimNet: Enabling Robust Unknown Object Manipulation from Pure Synthetic Data via Stereo Thomas Kollar, Michael Laskey, Kevin Stone, Brijen Thananjeyan

null 26 Sep 23, 2021