Skip to main content
Warning: You are using the test version of PyPI. This is a pre-production deployment of Warehouse. Changes made here affect the production instance of TestPyPI (
Help us improve Python packaging - Donate today!

Aerospike Client Library for Python

Project Description


The Python client for Aerospike works with Python 2.6, 2.7, 3.4, 3.5 running on 64-bit OS X 10.9+ and Linux.

The client depends on:

  • Python devel package
  • OpenSSL
  • The Aerospike C client

RedHat 6+ and CentOS 6+

The following are dependencies for:

  • RedHat Enterprise (RHEL) 6 or newer
  • CentOS 6 or newer
  • Related distributions which use the yum package manager
sudo yum install python-devel
sudo yum install openssl-devel

Debian 6+ and Ubuntu 12.04+

The following are dependencies for:

  • Debian 6 or newer
  • Ubuntu 12.04 or newer
  • Related distributions which use the apt package manager
sudo apt-get install python-dev
sudo apt-get install libssl-dev


By default OS X will be missing command line tools. On Mavericks (OS X 10.9) and higher those can be installed without Xcode.

xcode-select --install # install the command line tools, if missing

OpenSSL can be installed through the Homebrew OS X package manager.

brew install openssl


Aerospike Python Client can be installed using pip:

pip install aerospike

# to troubleshoot pip versions >= 6.0 you can
pip install --no-cache-dir aerospike

# to trouleshoot installation on OS X El-Capitan (10.11) or OS X Sierra (10.12)
pip install --no-cache-dir --user aerospike

# to have pip copy the Lua system files to a dir other than /usr/local/aerospike/lua
pip install aerospike --install-option="--lua-system-path=/opt/aerospike/lua"

If you run into trouble installing the client on a supported OS, you may be using an outdated pip. Versions of pip older than 7.0.0 should be upgraded, as well as versions of setuptools older than 18.0.0.

OS X Installation

Upgrading pip on OS X El-Capitan (10.11) or OS X Sierra(10.12) runs into SIP issues with pip install --user aerospike as the recommended workaround to install aerospike on those versions of OS X.

Attempting to install the client with pip for the system default Python may cause permssions issues when copying necesarry files. In order to avoid those issues the client can be installed for the current user only with the command: pip install --user aerospike

If the version of Python is not in the officially supported list, or the --install-option argument is provided, pip will attempt to compile the client from source. Please see the build directions in the GitHub repository to troubleshoot any issues caused by compiling the client.


For instructions on manually building the Python client, please refer to the file in this repo.


Documentation is hosted at and at


Example applications are provided in the examples directory of the GitHub repository

For examples, to run the

python examples/client/


To run the benchmarks the python module ‘tabulate’ need to be installed. In order to display heap information the module guppy must be installed. Note that guppy is only available for Python2. If guppy is not installed the benchmarks will still be runnable. Benchmark applications are provided in the benchmarks directory of the GitHub repository

By default the benchmarks will try to connect to a server located at , instructions on changing that setting and other command line flags may be displayed by appending the –help argument to the benchmark script. For example:

python benchmarks/ --help


The Aerospike Python Client is made availabled under the terms of the Apache License, Version 2, as stated in the file LICENSE.

Individual files may be made available under their own specific license, all compatible with Apache License, Version 2. Please see individual files for details.

Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
aerospike-2.1.1-cp26-none-macosx_10_6_intel.macosx_10_9_intel.macosx_10_9_x86_64.macosx_10_10_intel.macosx_10_10_x86_64.macosx_10_11_intel.macosx_10_11_x86_64.macosx_10_12_intel.macosx_10_12_x86_64.whl (391.0 kB) Copy SHA256 Checksum SHA256 cp26 Wheel Jun 21, 2017
aerospike-2.1.1-cp27-none-macosx_10_6_intel.macosx_10_9_intel.macosx_10_9_x86_64.macosx_10_10_intel.macosx_10_10_x86_64.macosx_10_11_intel.macosx_10_11_x86_64.macosx_10_12_intel.macosx_10_12_x86_64.whl (391.0 kB) Copy SHA256 Checksum SHA256 cp27 Wheel Jun 21, 2017
aerospike-2.1.1-cp34-cp34m-macosx_10_6_intel.macosx_10_9_intel.macosx_10_9_x86_64.macosx_10_10_intel.macosx_10_10_x86_64.macosx_10_11_intel.macosx_10_11_x86_64.macosx_10_12_intel.macosx_10_12_x86_64.whl (386.9 kB) Copy SHA256 Checksum SHA256 cp34 Wheel Jun 21, 2017
aerospike-2.1.1-cp35-cp35m-macosx_10_6_intel.macosx_10_9_intel.macosx_10_9_x86_64.macosx_10_10_intel.macosx_10_10_x86_64.macosx_10_11_intel.macosx_10_11_x86_64.macosx_10_12_intel.macosx_10_12_x86_64.whl (387.0 kB) Copy SHA256 Checksum SHA256 cp35 Wheel Jun 21, 2017
aerospike-2.1.1-cp36-cp36m-macosx_10_6_intel.macosx_10_9_intel.macosx_10_9_x86_64.macosx_10_10_intel.macosx_10_10_x86_64.macosx_10_11_intel.macosx_10_11_x86_64.macosx_10_12_intel.macosx_10_12_x86_64.whl (387.0 kB) Copy SHA256 Checksum SHA256 cp36 Wheel Jun 21, 2017
aerospike-2.1.1.tar.gz (108.8 kB) Copy SHA256 Checksum SHA256 Source Jun 21, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting