Skip to main content

Package for building OpenCV 3.4.1 including Python 3 bindings from the official sources.

Project description

# OpenCV Hands-Free

Unofficial OpenCV builder for Python.

This package aims at building OpenCV with Python bindings from the official sources. It provides a simple command line interface for starting the process of downloading the official sources, configuring the build dependencies, compiling and installing the resulting CV2 shared object within a virtual environment.

In contrast to [opencv-python](https://github.com/skvark/opencv-python) it will not provide any wheels and therefore the installation / build process will be by far slower (depending on the actual system performance).

IMPORTANT NOTE

Depending on the usage and system dependencies, the on-the-fly build output can contain video and GUI functionality and the contrib package.

## Features

  • builds against Python >= 3.4
  • runs and builds inside virtual environment
  • includes video support
  • supports OpenCV check (import, build information)
  • compiles with many flags enabled (which???)

## Supported OS

  • Debian Jessie, Stretch
  • Ubuntu 16.04
  • LinuxMint 18.2
  • Manjaro
  • Arch
  • Raspbian 9 (Stretch)

## Supported Python runtimes

  • CPython 3.4, 3.5, 3.6
  • PyPy (not yet)

Note: PyPy (5.10) is not supported yet due to missing path variables in module sysconfig.

## Installation

1. Use a Python’s [virtual environment](https://docs.python.org/3/library/venv.html) or even better install the package via [pipenv](https://docs.pipenv.org/): pipenv install cvbuilder 1. Follow instructions below

## Usage

After installing the package via pip / pipenv, you can manually invoke cvbuilder commands.

### Install system dependencies

`bash cvbuilder system --enable-gui --enable-video `

### Download, configure, build, install

The do-it-all command is:

`bash cvbuilder build `

or if you already downloaded the source zip files in the default temporary directory or need to rerun the process in a clean way:

`bash cvbuilder build --clean `

## Custom

If you need to run the individual steps (i.e. for debugging) the following commands are provided.

### Download sources

`bash cvbuilder download `

### Generate make config

`bash cvbuilder configure [--tmpdir XYZ] `

### Compile

`bash cvbuilder make `

### Install

`bash cvbuilder install `

### Dump

`bash cvbuilder dump `

### Check

You can run the check command:

`bash cvbuilder check `

in order to check whether the build process and installation worked.

# Running OpenCV

Now everything should be up and running and you should be able to work with OpenCV:

1. Start a python REPL: pipenv run python 1. Import the CV package: import cv2 1. Read [OpenCV documentation](http://docs.opencv.org/>)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for cvbuilder, version 0.2.10
Filename, size File type Python version Upload date Hashes
Filename, size cvbuilder-0.2.10.zip (289.8 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page