From f9fd88fb011f4a7acb6b82dd14de663f4efaed60 Mon Sep 17 00:00:00 2001 From: Onuralp SEZER Date: Thu, 28 Mar 2024 17:55:11 +0300 Subject: [PATCH 1/3] =?UTF-8?q?docs:=20=F0=9F=93=9A=20conda=20and=20mamba?= =?UTF-8?q?=20installation=20methods=20added?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Onuralp SEZER --- docs/index.md | 101 +++++++++++++++++++++++++++++++------------------- 1 file changed, 62 insertions(+), 39 deletions(-) diff --git a/docs/index.md b/docs/index.md index 17151f5e7..e69ca201c 100644 --- a/docs/index.md +++ b/docs/index.md @@ -33,60 +33,83 @@ We write your reusable computer vision tools. Whether you need to load your data You can install `supervision` with pip in a [**Python>=3.8**](https://www.python.org/) environment. -!!! example "pip install (recommended)" +!!! success "Installation" - === "headless" - The headless installation of `supervision` is designed for environments where graphical user interfaces (GUI) are not needed, making it more lightweight and suitable for server-side applications. + !!! example "Pip installation (recommended)" - ```bash - pip install supervision - ``` + === "Headless" + The headless installation of `supervision` is designed for environments where graphical user interfaces (GUI) are not needed, making it more lightweight and suitable for server-side applications. - === "desktop" - If you require the full version of `supervision` with GUI support you can install the desktop version. This version includes the GUI components of OpenCV, allowing you to display images and videos on the screen. + ```bash + pip install supervision + ``` - ```bash - pip install "supervision[desktop]" - ``` + === "Desktop" + The desktop installation of `supervision` is designed with GUI support. This version includes the GUI components of OpenCV, allowing you to display images and videos on the screen. -!!! example "git clone (for development)" + ```bash + pip install "supervision[desktop]" + ``` - === "virtualenv" + !!! example "Conda/Mamba installation" - ```bash - # clone repository and navigate to root directory - git clone https://github.com/roboflow/supervision.git - cd supervision + === "conda" + The Conda installation of `supervision` is designed for those who prefer using Conda as their package manager. It's especially useful for managing complex dependencies and environments. - # setup python environment and activate it - python3 -m venv venv - source venv/bin/activate - pip install --upgrade pip + [![Conda Recipe](https://img.shields.io/badge/recipe-supervision-green.svg)](https://anaconda.org/conda-forge/supervision) [![Conda Downloads](https://img.shields.io/conda/dn/conda-forge/supervision.svg)](https://anaconda.org/conda-forge/supervision) [![Conda Version](https://img.shields.io/conda/vn/conda-forge/supervision.svg)](https://anaconda.org/conda-forge/supervision) [![Conda Platforms](https://img.shields.io/conda/pn/conda-forge/supervision.svg)](https://anaconda.org/conda-forge/supervision) - # headless install - pip install -e "." - # desktop install - pip install -e ".[desktop]" - ``` + ```bash + conda install -c conda-forge supervision + ``` - === "poetry" + === "mamba" + The Mamba installation of `supervision` is ideal for those who prefer using Mamba as their package manager. - ```bash - # clone repository and navigate to root directory - git clone https://github.com/roboflow/supervision.git - cd supervision + [![Mamba Recipe](https://img.shields.io/badge/recipe-supervision-green.svg)](https://anaconda.org/conda-forge/supervision) [![Mamba Downloads](https://img.shields.io/conda/dn/conda-forge/supervision.svg)](https://anaconda.org/conda-forge/supervision) [![Mamba Version](https://img.shields.io/conda/vn/conda-forge/supervision.svg)](https://anaconda.org/conda-forge/supervision) [![Mamba Platforms](https://img.shields.io/conda/pn/conda-forge/supervision.svg)](https://anaconda.org/conda-forge/supervision) - # setup python environment and activate it - poetry env use python3.10 - poetry shell + ```bash + mamba install -c conda-forge supervision + ``` - # headless install - poetry install + !!! example "git clone (for development)" - # desktop install - poetry install --extras "desktop" - ``` + === "virtualenv" + + ```bash + # clone repository and navigate to root directory + git clone https://github.com/roboflow/supervision.git + cd supervision + + # setup python environment and activate it + python3 -m venv venv + source venv/bin/activate + pip install --upgrade pip + + # headless install + pip install -e "." + + # desktop install + pip install -e ".[desktop]" + ``` + + === "poetry" + + ```bash + # clone repository and navigate to root directory + git clone https://github.com/roboflow/supervision.git + cd supervision + + # setup python environment and activate it + poetry env use python3.10 + poetry shell + + # headless install + poetry install + + # desktop install + poetry install --extras "desktop" + ``` ## 🚀 Quickstart From e88ab7c125c309a14f152e0fbef3603fed8a4f97 Mon Sep 17 00:00:00 2001 From: SkalskiP Date: Thu, 28 Mar 2024 18:53:39 +0100 Subject: [PATCH 2/3] small update --- README.md | 10 ++--- docs/index.md | 108 ++++++++++++++++++++++++-------------------------- 2 files changed, 56 insertions(+), 62 deletions(-) diff --git a/README.md b/README.md index 7196a6538..7d280b575 100644 --- a/README.md +++ b/README.md @@ -18,10 +18,10 @@ [![downloads](https://img.shields.io/pypi/dm/supervision)](https://pypistats.org/packages/supervision) [![license](https://img.shields.io/pypi/l/supervision)](https://github.com/roboflow/supervision/blob/main/LICENSE.md) [![python-version](https://img.shields.io/pypi/pyversions/supervision)](https://badge.fury.io/py/supervision) -[![Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/roboflow/supervision/blob/main/demo.ipynb) -[![Gradio](https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Spaces-blue)](https://huggingface.co/spaces/Roboflow/Annotators) -[![Discord](https://img.shields.io/discord/1159501506232451173)](https://discord.gg/GbfgXGJ8Bk) -[![Built with Material for MkDocs](https://img.shields.io/badge/Material_for_MkDocs-526CFE?logo=MaterialForMkDocs&logoColor=white)](https://squidfunk.github.io/mkdocs-material/) +[![colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/roboflow/supervision/blob/main/demo.ipynb) +[![gradio](https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Spaces-blue)](https://huggingface.co/spaces/Roboflow/Annotators) +[![discord](https://img.shields.io/discord/1159501506232451173)](https://discord.gg/GbfgXGJ8Bk) +[![built-with-material-for-mkdocs](https://img.shields.io/badge/Material_for_MkDocs-526CFE?logo=MaterialForMkDocs&logoColor=white)](https://squidfunk.github.io/mkdocs-material/) ## 👋 hello @@ -39,7 +39,7 @@ Pip install the supervision package in a pip install supervision ``` -Read more about desktop, headless, and local installation in our [guide](https://roboflow.github.io/supervision/). +Read more about conda, mamba, and installing from source in our [guide](https://roboflow.github.io/supervision/). ## 🔥 quickstart diff --git a/docs/index.md b/docs/index.md index e69ca201c..62768b676 100644 --- a/docs/index.md +++ b/docs/index.md @@ -30,87 +30,81 @@ We write your reusable computer vision tools. Whether you need to load your data ## 💻 Install -You can install `supervision` with pip in a +You can install `supervision` in a [**Python>=3.8**](https://www.python.org/) environment. -!!! success "Installation" +!!! example "pip install (recommended)" - !!! example "Pip installation (recommended)" + === "headless" + The headless installation of `supervision` is designed for environments where graphical user interfaces (GUI) are not needed, making it more lightweight and suitable for server-side applications. - === "Headless" - The headless installation of `supervision` is designed for environments where graphical user interfaces (GUI) are not needed, making it more lightweight and suitable for server-side applications. + ```bash + pip install supervision + ``` - ```bash - pip install supervision - ``` + === "desktop" + If you require the full version of `supervision` with GUI support you can install the desktop version. This version includes the GUI components of OpenCV, allowing you to display images and videos on the screen. - === "Desktop" - The desktop installation of `supervision` is designed with GUI support. This version includes the GUI components of OpenCV, allowing you to display images and videos on the screen. + ```bash + pip install "supervision[desktop]" + ``` - ```bash - pip install "supervision[desktop]" - ``` +!!! example "conda/mamba install" - !!! example "Conda/Mamba installation" + === "conda" - === "conda" - The Conda installation of `supervision` is designed for those who prefer using Conda as their package manager. It's especially useful for managing complex dependencies and environments. + [![conda-recipe](https://img.shields.io/badge/recipe-supervision-green.svg)](https://anaconda.org/conda-forge/supervision) [![conda-downloads](https://img.shields.io/conda/dn/conda-forge/supervision.svg)](https://anaconda.org/conda-forge/supervision) [![conda-version](https://img.shields.io/conda/vn/conda-forge/supervision.svg)](https://anaconda.org/conda-forge/supervision) [![conda-platforms](https://img.shields.io/conda/pn/conda-forge/supervision.svg)](https://anaconda.org/conda-forge/supervision) - [![Conda Recipe](https://img.shields.io/badge/recipe-supervision-green.svg)](https://anaconda.org/conda-forge/supervision) [![Conda Downloads](https://img.shields.io/conda/dn/conda-forge/supervision.svg)](https://anaconda.org/conda-forge/supervision) [![Conda Version](https://img.shields.io/conda/vn/conda-forge/supervision.svg)](https://anaconda.org/conda-forge/supervision) [![Conda Platforms](https://img.shields.io/conda/pn/conda-forge/supervision.svg)](https://anaconda.org/conda-forge/supervision) + ```bash + conda install -c conda-forge supervision + ``` + === "mamba" - ```bash - conda install -c conda-forge supervision - ``` + [![mamba-recipe](https://img.shields.io/badge/recipe-supervision-green.svg)](https://anaconda.org/conda-forge/supervision) [![mamba-downloads](https://img.shields.io/conda/dn/conda-forge/supervision.svg)](https://anaconda.org/conda-forge/supervision) [![mamba-version](https://img.shields.io/conda/vn/conda-forge/supervision.svg)](https://anaconda.org/conda-forge/supervision) [![mamba-platforms](https://img.shields.io/conda/pn/conda-forge/supervision.svg)](https://anaconda.org/conda-forge/supervision) - === "mamba" - The Mamba installation of `supervision` is ideal for those who prefer using Mamba as their package manager. + ```bash + mamba install -c conda-forge supervision + ``` - [![Mamba Recipe](https://img.shields.io/badge/recipe-supervision-green.svg)](https://anaconda.org/conda-forge/supervision) [![Mamba Downloads](https://img.shields.io/conda/dn/conda-forge/supervision.svg)](https://anaconda.org/conda-forge/supervision) [![Mamba Version](https://img.shields.io/conda/vn/conda-forge/supervision.svg)](https://anaconda.org/conda-forge/supervision) [![Mamba Platforms](https://img.shields.io/conda/pn/conda-forge/supervision.svg)](https://anaconda.org/conda-forge/supervision) +!!! example "git clone (for development)" - ```bash - mamba install -c conda-forge supervision - ``` + === "virtualenv" - !!! example "git clone (for development)" + ```bash + # clone repository and navigate to root directory + git clone https://github.com/roboflow/supervision.git + cd supervision - === "virtualenv" + # setup python environment and activate it + python3 -m venv venv + source venv/bin/activate + pip install --upgrade pip - ```bash - # clone repository and navigate to root directory - git clone https://github.com/roboflow/supervision.git - cd supervision + # headless install + pip install -e "." - # setup python environment and activate it - python3 -m venv venv - source venv/bin/activate - pip install --upgrade pip + # desktop install + pip install -e ".[desktop]" + ``` - # headless install - pip install -e "." + === "poetry" - # desktop install - pip install -e ".[desktop]" - ``` + ```bash + # clone repository and navigate to root directory + git clone https://github.com/roboflow/supervision.git + cd supervision - === "poetry" + # setup python environment and activate it + poetry env use python3.10 + poetry shell - ```bash - # clone repository and navigate to root directory - git clone https://github.com/roboflow/supervision.git - cd supervision - - # setup python environment and activate it - poetry env use python3.10 - poetry shell - - # headless install - poetry install - - # desktop install - poetry install --extras "desktop" - ``` + # headless install + poetry install + # desktop install + poetry install --extras "desktop" + ``` ## 🚀 Quickstart From 719af725b1751c99713983587dc5c5f9b6a30622 Mon Sep 17 00:00:00 2001 From: "pre-commit-ci[bot]" <66853113+pre-commit-ci[bot]@users.noreply.github.com> Date: Thu, 28 Mar 2024 17:53:55 +0000 Subject: [PATCH 3/3] =?UTF-8?q?fix(pre=5Fcommit):=20=F0=9F=8E=A8=20auto=20?= =?UTF-8?q?format=20pre-commit=20hooks?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/index.md b/docs/index.md index 62768b676..fc7cda423 100644 --- a/docs/index.md +++ b/docs/index.md @@ -30,7 +30,7 @@ We write your reusable computer vision tools. Whether you need to load your data ## 💻 Install -You can install `supervision` in a +You can install `supervision` in a [**Python>=3.8**](https://www.python.org/) environment. !!! example "pip install (recommended)"