Skip to main content
Donate to the Python Software Foundation or Purchase a PyCharm License to Benefit the PSF! Donate Now

Minimal, modern embedded V8 for Python.

Project description

Minimal, modern embedded V8 for Python.

  • Free software: ISC license


  • Unicode support
  • Thread safe
  • Re-usable contexts
  • Binary object is Python agnostic

MiniRacer can be easily used by Django or Flask projects to minify assets, run babel or compile CoffeeScript.


py_mini_racer is straightforward to use:

>>> from py_mini_racer import py_mini_racer
>>> ctx = py_mini_racer.MiniRacer()
>>> ctx.eval('1+1')
>>> ctx.eval("var x = {company: 'Sqreen'};")
>>> print ctx.eval(u"'\N{HEAVY BLACK HEART}'")

>>> ctx.eval("var fun = () => ({ foo: 1 });")
{u'foo': 1}

Variables are kept inside of a context:

>>> ctx.eval("")
[1,2,3].map(n => n + 1);


PyMiniRacer is only compatible with Python 2.7 at the moment. Python 3 support is on its way.

Binary builds availability

The PyMiniRacer binary builds have been tested on x86_64 with: * OSX 10.11 * Ubuntu >= 14.04 * Debian >= 8 * CentOS >= 7

It should work on any Linux with a libc >= 2.17.


We built Python wheels (prebuilt binaries) for OSX 64 bits and Linux 64 bits - most recent distributions. You need pip >= 1.4 and setuptools >= 0.8.

$ pip install py-mini-racer


You can build v8 with the command:

$ python build_v8

You can also build the ctype extension:

$ python build_ext

Which automatically builds v8.

You can generate a wheel with the command:

$ python bdist_wheel

which builds v8, the extension, and generates a wheel.


If you want to run the tests, you need to build V8 first, then launch:

$ python test --addopts tests


Built with love by Sqreen.

PyMiniRacer is inspired by mini_racer, built for the Ruby world by Sam Saffron.

Tools used in rendering this package:


Lower libc version needed. Export V8 version. Fix circular structures export.


0.1.1 (2016-08-02)

  • Fix sdist distribution.

0.1.0 (2016-08-01)

  • First release on PyPI.

Project details

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
py_mini_racer-0.1.1-cp27-cp27m-macosx_10_11_x86_64.whl (3.9 MB) Copy SHA256 hash SHA256 Wheel cp27
py_mini_racer-0.1.1-cp27-cp27mu-manylinux1_x86_64.whl (5.0 MB) Copy SHA256 hash SHA256 Wheel cp27
py_mini_racer-0.1.1-cp35-cp35m-macosx_10_11_x86_64.whl (3.9 MB) Copy SHA256 hash SHA256 Wheel cp35
py_mini_racer-0.1.1.tar.gz (323.3 kB) Copy SHA256 hash SHA256 Source None

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 SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page