Installation Notes¶
Supported Systems¶
DeFFcode is well-tested and supported on the following systems(but not limited to), with python 3.7+ and pip installed:
Upgrade your pip
It strongly advised to upgrade to latest pip before installing deffcode to avoid any undesired installation error(s).
There are two mechanisms to upgrade pip
:
You can use existing pip
to upgrade itself:
Install pip
if not present
- Download the script, from https://bootstrap.pypa.io/get-pip.py.
- Open a terminal/command prompt,
cd
to the folder containing theget-pip.py
file and run:
More details about this script can be found in pypa/get-pip’s README.
- Any Linux distro released in 2016 or later
- Windows 7 or later
- MacOS 10.12.6 (Sierra) or later
Supported Python legacies¶
Python 3.7+ are only supported legacies for installing DeFFcode v0.1.0
and above.
Prerequisites¶
DeFFcode APIs requires FFmpeg binaries to be installed for all of its core functionality.
FFmpeg¶
When installing DeFFcode, FFmpeg is the only prerequisites you need to configure/install manually. You could easily do it by referring FFmpeg Installation doc.
Installation¶
A. Installation using pip (Recommended)¶
Best option for easily getting stable DeFFcode installed.
Installation is as simple as:
Windows Installation
If you are using Windows, some of the commands given below, may not work out-of-the-box.
A quick solution may be to preface every Python command with python -m
like this:
And, If you don't have the privileges to the directory you're installing package. Then use --user
flag, that makes pip install packages in your home directory instead:
Or, If you're using py
as alias for installed python, then:
And you can also download its wheel (.whl
) package from our repository's releases section, thereby can be installed as follows:
B. Installation from Source¶
Best option for trying latest patches(maybe experimental), forking for Pull Requests, or automatically installing all prerequisites(with a few exceptions).
Installation using dev
banch
If you're looking for latest work-in-progress enhancements or bug-fixes, then you want to checkout our beta dev
branch with the following commands:
The beta dev
branch at times can be very unstable or even unusable, User discretion is advised!
Windows Installation
If you are using Windows, some of the commands given below, may not work out-of-the-box.
A quick solution may be to preface every Python command with python -m
like this:
And, If you don't have the privileges to the directory you're installing package. Then use --user
flag, that makes pip install packages in your home directory instead:
Or, If you're using py
as alias for installed python, then:
# clone the repository and get inside
git clone https://github.com/abhiTronix/deffcode.git && cd deffcode
# Install it
pip install -U .
-
The
ensurepip
module is missing/disabled on Ubuntu. Usepip
method only. ↩