NumPy aware dynamic Python compiler using LLVM
Python C Jupyter Notebook C++ Batchfile Shell Other
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.github Fix MD list syntax in issue template. Apr 24, 2018
benchmarks Merge remote-tracking branch 'origin/master' into devel May 22, 2014
bin Fix problem with conda-build that entrypoint scripts are not installed Apr 16, 2015
buildscripts Merge pull request #3128 from stuartarchibald/wip/jetson_tx2 Aug 15, 2018
docs Add NumPy 1.15 support Aug 15, 2018
examples Add execute bits back on to examples Jul 5, 2018
numba Merge pull request #3171 from sklam/fix/iss3146 Aug 16, 2018
tutorials Make use of the common spelling of heterogeneous/homogeneous. Jun 25, 2018
.binstar.yml Revert unwanted changes in binstar.yml Jun 30, 2015
.coveragerc Ignore vendored packages in coverage Mar 15, 2016
.gitattributes add versioneer Feb 2, 2013
.gitignore cleaned up .gitignore? Mar 22, 2018
.travis.yml Merge pull request #3227 from stuartarchibald/wip/np115 Aug 15, 2018
AUTHORS Rename Continuum to Anaconda Aug 28, 2017
CHANGE_LOG Fix changelog formatting Jul 6, 2018
CONTRIBUTING.md Fix markdown in CONTRIBUTING.md Dec 4, 2017
LICENSE Fixes from review Aug 28, 2017
LICENSES.third-party Add licenses for vendored libraries Mar 15, 2016
MANIFEST.in Respond to review feedback Jul 11, 2018
README.rst Add NumPy 1.15 support Aug 15, 2018
appveyor.yml Add NumPy 1.15 support Aug 15, 2018
codecov.yml Also disable the "changes" status May 3, 2016
condatestall.py Add option for quick test on all python version Jun 3, 2014
requirements.txt Updates for llvmlite 0.25 Jul 27, 2018
run_coverage.py Try out codecov.io Mar 9, 2016
runtests.py Add method of switching off colored error messages. Apr 13, 2018
setup.py Merge pull request #3178 from stuartarchibald/roc/doc_update_1 Aug 2, 2018
versioneer.py Fix #1141: add install_requires to setup.py May 13, 2015

README.rst

Numba

Gitter

A compiler for Python array and numerical functions

Numba is an Open Source NumPy-aware optimizing compiler for Python sponsored by Anaconda, Inc. It uses the remarkable LLVM compiler infrastructure to compile Python syntax to machine code.

It is aware of NumPy arrays as typed memory regions and so can speed-up code using NumPy arrays. Other, less well-typed code will be translated to Python C-API calls effectively removing the "interpreter" but not removing the dynamic indirection.

Numba is also not a tracing JIT. It compiles your code before it gets run either using run-time type information or type information you provide in the decorator.

Numba is a mechanism for producing machine code from Python syntax and typed data structures such as those that exist in NumPy.

Dependencies

  • llvmlite
  • numpy (version 1.9 or higher)
  • funcsigs (for Python 2)

Installing

The easiest way to install numba and get updates is by using the Anaconda Distribution: https://www.anaconda.com/download

$ conda install numba

If you wanted to compile Numba from source, it is recommended to use conda environment to maintain multiple isolated development environments. To create a new environment for Numba development:

$ conda create -p ~/dev/mynumba python numpy llvmlite

To select the installed version, append "=VERSION" to the package name, where, "VERSION" is the version number. For example:

$ conda create -p ~/dev/mynumba python=2.7 numpy=1.11 llvmlite

to use Python 2.7 and Numpy 1.11.

If you need CUDA support, you should also install the CUDA toolkit:

$ conda install cudatoolkit

This installs the CUDA Toolkit version 8.0, which requires driver version 375.x or later to be installed.

Custom Python Environments

If you're not using conda, you will need to build llvmlite yourself:

Building and installing llvmlite

See https://github.com/numba/llvmlite for the most up-to-date instructions. You will need a build of LLVM 6.0.x.

$ git clone https://github.com/numba/llvmlite
$ cd llvmlite
$ python setup.py install
Installing Numba
$ git clone https://github.com/numba/numba.git
$ cd numba
$ pip install -r requirements.txt
$ python setup.py build_ext --inplace
$ python setup.py install

or simply

$ pip install numba

If you want to enable CUDA support, you will need to install CUDA Toolkit 8.0. After installing the toolkit, you might have to specify environment variables in order to override the standard search paths:

NUMBAPRO_CUDA_DRIVER
Path to the CUDA driver shared library
NUMBAPRO_NVVM
Path to the CUDA libNVVM shared library file
NUMBAPRO_LIBDEVICE
Path to the CUDA libNVVM libdevice directory which contains .bc files

Documentation

http://numba.pydata.org/numba-doc/dev/index.html

Mailing Lists

Join the numba mailing list numba-users@continuum.io: https://groups.google.com/a/continuum.io/d/forum/numba-users

or access it through the Gmane mirror: http://news.gmane.org/gmane.comp.python.numba.user

Some old archives are at: http://librelist.com/browser/numba/

Website

See if our sponsor can help you (which can help this project): https://www.anaconda.com

http://numba.pydata.org

Continuous Integration

https://travis-ci.org/numba/numba