<!--
===============================================
vidgear library source-code is deployed under the Apache 2.0 License:

Copyright (c) 2019 Abhishek Thakur(@abhiTronix) <abhi.una12@gmail.com>

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
===============================================
-->

<figure>
  <img src="../assets/images/installation.png" loading="lazy" alt="VidGear Installation" class="center"/>
</figure>

&emsp; 

# Installation Overview


## Supported Systems

VidGear is well-tested and supported on the following systems(but not limited to), with [python 3.10+](https://www.python.org/downloads/) and [pip](https://pip.pypa.io/en/stable/getting-started/) installed:

* Any :material-linux: Linux distro released in 2016 or later
* :fontawesome-brands-windows: Windows 7 or later
* :material-apple: MacOS 10.12.6 (Sierra) or later

&thinsp;

## Supported Python legacies

!!! warning "Depreciation Notice"

    Python-3.9 legacies support has been dropped from Vidgear.

:fontawesome-brands-python: [**Python 3.10+**](https://www.python.org/downloads/) are only supported legacies for installing Vidgear `v0.3.4` and above.

&thinsp;

## Installation methods

* [Install using pip :simple-pypi:](../installation/pip_install/) _(recommended)_
* [Install from source :material-hammer-wrench:](../installation/source_install/)

??? example "Looking for containerizing VidGear with :simple-docker: Docker?"
    Checkout this guide that addresses the unique challenges of containerizing VidGear applications, particularly around building OpenCV with proper GStreamer and FFmpeg support. Learn the patterns and pitfalls before you start: [**Containerizing VidGear with Docker ➶**](bonus/docker_example.md)

&thinsp;