# Installation

Install the Developer SDK for your language. The Java SDK targets **Java 21+**; Python examples assume **Python 3.10+** unless noted otherwise.

## Requirements

-   [Java](#tab-panel-2668)
-   [Python](#tab-panel-2669)

| Requirement | Minimum Version |
| --- | --- |
| Java | 21+ |
| Maven | 3.6+ (if using Maven) |
| Gradle | 7.0+ (if using Gradle) |

| Requirement | Minimum Version |
| --- | --- |
| Python | 3.10+ |
| pip | 21.0+ |

## Install the SDK

-   [Java](#tab-panel-2674)
-   [Python](#tab-panel-2675)

### Maven

Add the dependency to your `pom.xml`:

```xml
<dependency>

    <groupId>com.aerospike</groupId>

    <artifactId>aerospike-client-sdk</artifactId>

    <version>0.9.0-alpha</version>

</dependency>
```

### Gradle (Groovy)

Add to your `build.gradle`:

```groovy
dependencies {

    implementation 'com.aerospike:aerospike-client-sdk:0.9.0-alpha'

}
```

### Gradle (Kotlin)

Add to your `build.gradle.kts`:

```kotlin
dependencies {

    implementation("com.aerospike:aerospike-client-sdk:0.9.0-alpha")

}
```

### pip

Terminal window

```bash
pip install aerospike-sdk
```

### With version pinning (recommended for production)

Terminal window

```bash
pip install aerospike-sdk==1.0.0
```

### In a virtual environment (recommended)

Terminal window

```bash
python -m venv .venv

source .venv/bin/activate  # On Windows: .venv\Scripts\activate

pip install aerospike-sdk
```

### `requirements.txt` file

Add to your `requirements.txt`:

```text
aerospike-sdk>=1.0.0,<2.0.0
```

Then install:

Terminal window

```bash
pip install -r requirements.txt
```

## Verify installation

-   [Java](#tab-panel-2670)
-   [Python](#tab-panel-2671)

Create a simple test file `VerifyInstall.java`:

```java
import com.aerospike.client.sdk.DataSet;

public class VerifyInstall {

    public static void main(String[] args) {

        DataSet ds = DataSet.of("test", "example");

        System.out.println("✓ Aerospike Java SDK on classpath: " + ds.getNamespace() + "/" + ds.getSet());

    }

}
```

Run it:

Terminal window

```bash
# Maven

mvn compile exec:java -Dexec.mainClass="VerifyInstall"

# Gradle

./gradlew run
```

Expected output:

```plaintext
✓ Aerospike Java SDK on classpath: test/example
```

Run this in your Python environment:

```python
import aerospike_sdk

print(f"Developer SDK version: {aerospike_sdk.__version__}")

print("✓ Installation successful!")
```

Or from the command line:

Terminal window

```bash
python -c "import aerospike_sdk; print(f'Version: {aerospike_sdk.__version__}')"
```

Expected output:

```plaintext
Developer SDK version: <your installed version>

✓ Installation successful!
```

## IDE setup

-   [Java](#tab-panel-2676)
-   [Python](#tab-panel-2677)

### IntelliJ IDEA

1.  Open your project
2.  Right-click `pom.xml` (Maven) or `build.gradle` (Gradle)
3.  Select **Maven > Reload Project** or **Gradle > Refresh Gradle Project**
4.  Auto-complete and Javadoc should now work for Developer SDK classes

### VS Code

1.  Install the [Extension Pack for Java](https://marketplace.visualstudio.com/items?itemName=vscjava.vscode-java-pack)
2.  Open your project folder
3.  VS Code will automatically detect your build file and index dependencies

### PyCharm

1.  Open your project
2.  Go to **File > Settings > Project > Python Interpreter**
3.  Ensure your virtual environment is selected
4.  PyCharm will index the package for auto-complete

### VS Code

1.  Install the [Python extension](https://marketplace.visualstudio.com/items?itemName=ms-python.python)
2.  Select your Python interpreter (Ctrl/Cmd + Shift + P > “Python: Select Interpreter”)
3.  Choose your virtual environment with `aerospike-sdk` installed

## Upgrading

-   [Java](#tab-panel-2672)
-   [Python](#tab-panel-2673)

Update the version number in your `pom.xml` or `build.gradle`:

```xml
<version>1.1.0</version>  <!-- Update to new version -->
```

Then refresh your dependencies:

Terminal window

```bash
# Maven

mvn clean install

# Gradle

./gradlew build --refresh-dependencies
```

Terminal window

```bash
pip install --upgrade aerospike-sdk
```

Or to upgrade to a specific version:

Terminal window

```bash
pip install aerospike-sdk==1.1.0
```

## Troubleshooting

### Maven: dependency not found

If Maven can’t find the package:

1.  Check you have the correct repository configured (Maven Central)
2.  Run `mvn clean install -U` to force update
3.  Verify your `pom.xml` syntax is correct

### Python: ImportError

If you get `ModuleNotFoundError: No module named 'aerospike_sdk'`:

1.  Make sure you’re using the correct Python environment
2.  Verify the package is installed: `pip list | grep aerospike`
3.  Try reinstalling: `pip uninstall aerospike-sdk && pip install aerospike-sdk`

### SSL/TLS issues

If you need to connect to a TLS-enabled cluster, see [Connect to Aerospike](https://aerospike.com/docs/develop/client/sdk/connect) for TLS configuration.

## Next steps

Quickstart

Build your first app in 5 minutes.

[Quickstart →](https://aerospike.com/docs/develop/client/sdk/quickstart)

Connect to Aerospike

Configure connections, TLS, and authentication.

[Connect →](https://aerospike.com/docs/develop/client/sdk/connect)