API & SDK

Seamless integration with existing codebase

Integrate your existing codebase and tech stack with Supervisely via API and SDK to automate workflow.

$ curl -H "x-api-key: <token-here>" \
https://app.supervisely.com/public/api/v3/projects.list

{
"total": 12,
"perPage": 2,
"pagesCount": 6,
"entities": [
{
  "id": 1,
  "workspaceId": 1,
  "name": "lemon",
  "type": "images",
  "description": "ts12",
  "size": "861069",
  "status": "ready"
}

for dataset in cloned_project:
    print("Dataset: ", dataset.name)

    for item_name in dataset:
        ann_path = dataset.get_ann_path(item_name)
        ann = sly.Annotation.load_json_file(ann_path, cloned_project.meta)

        # Apply the filtering to find the labels to be retained.
        # Only keep Polygon labels with large enough area.
        retained_labels = [
            label for label in ann.labels
            if isinstance(label.geometry, sly.Polygon) and label.geometry.area > 120000]

        # Make a copy of the original annotation, but only keep
        # retained_labels there.
        ann_filtered = ann.clone(labels=retained_labels)

        # Update the annotation on disk.
        dataset.set_ann(item_name, ann_filtered)

Rich JSON API

Over 220 methods to retrieve, update and extract any information from the platform and even:

Change labeling interface for a particular user
Efficiently upload gigabytes of data with streams
Communicate with applications via websockets

View documentation

Powerful Python SDK

Not just another wrapper for API: Supervisely SDK covers every aspect of development, including:

Prepare data for model training and inference
Augment images together with annotations

View documentation
PIP package

In the heart of the platform

We polish our API and SDK not only because we need a way for our awesome community and customers to extend Supervisely and integrate it with existing workflows — everything from the core functionality like labeling toolboxes to Supervisely Apps is built with those toolkits.

With that you can be sure that every idea you might come up with can be easily done in Supervisely with the help of SDK and API.

Boundless customization with
Supervisely Apps

Constantly growing ecosystem of hundreds of ready-to-use apps that extend and add new functionality.

Learn about Ecosystem

SUPERVISELY FOR ENTERPRISES

On-premise edition built for your business

A fully customizable AI infrastructure, deployed on cloud or your servers with everything you love about Supervisely, plus advanced security, control, and support.

Start 30 days free trial➔

Maximum security: hosted behind firewall on your servers with advanced governance and privacy settings
Effortless integrations: single sign-on with LDAP or OpenID, cloud storage in AWS or Azure and powerful API & SDK
Priority support: dedicated slack chat, guided onboarding and personalized training sessions with experts

supervisely install
> downloading pre-requirements...
> pulling docker images...
> installing software...
> Done! Supervisely is running on port :80

supervisely update
> checking for updates...
> Your version is up to date!

#support

Team Manager 17:33

Hello @supervisely! Is there a way to create a project via API?

Supervisely 17:35

Sure thing, check out this docs!

Here’s why our customers trust us

We use Supervisely since 2019. The key advantage of this tool is that Supervisely provides a complete data treatment pipeline. An important advantage is that a Supervisely instance can be deployed autonomously on a Client infrastructure, and distributed on different servers.

It helps to treat enterprise’s internal and often confidential data in a secured way. Together with a user-friendly interface, a clear documentation and a friendly and reactive support team it helps us to do Data Scientist work better and faster.

Dmitriy Slutskiy

PhD Research Engineer

❮

❯

BMW Group is using the Supervise.ly solution to create automated verifications for ensuring a very high product quality across the whole production chain in vehicle and vehicle component manufacturing.

BMW Group uses Supervise.ly to annotate manufacturing images from production lines in their world-wide plants for enhancing quality inspections using deep learning. The Supervise.ly tooling also supports the process for continuously updating AI models using semi-automated labeling.

Supervise.ly is integrated into the BMW Group AI Platform in order to empower computer vision based AI use cases.

❮

❯

We originally set out to look for tools that could help us with data annotation, and we discovered that Supervisely excels at that and much more. It has become an integral part of our workflow in annotation, model training, and evaluation.

We've been exceedingly impressed with the customer support, addition of new features, and the flexibility of the publicly available SDK/API. The Supervisely team has also been fast to respond to support questions, and has shown a lot of openness when given feedback on potential improvements.

Travis Prosser

Engineering Specialist

❮

❯

We have been using Supervisely for a few years now to help label and organize our data for AI training. The interface is user-friendly and the tools are intuitive to use, which has made the annotation process much more efficient for our team. We run Supervisely locally, which allows us to stay in control of our data. We also use Supervisely for annotation reviews, and the review tools have been invaluable in ensuring the quality and accuracy. The Python SDK has also been incredibly helpful in automating and streamlining our workflow. In addition, the support team on Slack has been extremely helpful and responsive. The ability to collaborate with my colleagues on the same project has also been a huge time-saver.

Overall, we have been extremely satisfied with Supervisely and would highly recommend it to anyone in need of a reliable and efficient annotation solution.