Skip to content

Install the Aerospike client

For the complete documentation index see: llms.txt

All documentation pages available in markdown.

Prerequisites

The Python client for Aerospike works with Python 3.10 - 3.14 and supports the following operating systems:

  • macOS 14, 15, 26
  • Red Hat Enterprise Linux (RHEL) 9 and 10
  • Amazon Linux 2023
  • Debian 12 and 13
  • Ubuntu 22.04 and 24.04
  • Windows (x64)

The client is also verified to run on the following operating systems, but we do not officially support them. We do not distribute wheels or prioritize fixing bugs for these operating systems:

  • Alpine Linux

Install

Verify that Python and pip for your specific Python interpreter are installed on your system.

Run the following commands to install the Aerospike Python client.

pip install aerospike

To pin a release (for example when you pair a client with a specific Database version), specify the version explicitly:

pip install aerospike==19.3.0
python -m pip show aerospike
python -c "import aerospike"

Older examples apply when you target earlier Aerospike Database releases (for example, client 4.0.0 for Aerospike Database 4.9.0 and later).

pip install aerospike==<Aerospike Python Version>

Installing the client with pip for the system default Python may cause permissions issues when copying necessary files. To avoid those issues, specify the --user option to install the client for only the current user:

pip install --user aerospike

Development

For information about developing the Python client, see Manually Building the Python Client for Aerospike.