15.1.1 Installation

Prerequisites

Java

• Java ≥ 11 (latest LTS release recommended)
• Maven command-line tools

Python

• Python ≥ 3.10

Installing the SDK

Java

Step 1 — Install the SDK into your local Maven repository:

cd idmp-java-sdk
mvn install -DskipTests

Step 2 — Add the dependency to your project's pom.xml

<dependency>
  <groupId>com.taosdata</groupId>
  <artifactId>idmp-sdk</artifactId>
  <version>1.0.14.1</version>
</dependency>

Python

Navigate to the idmp-python-sdk directory and install with pip:

cd idmp-python-sdk
pip install .

tip

Install in a virtual environment to avoid dependency conflicts with other projects:

python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install .

Verifying the Installation

Java

Add the following import to your project. If it compiles without errors, the SDK is installed correctly:

import org.openapitools.client.ApiClient;
// If this compiles, the SDK is installed correctly

Python

python -c "import idmp_sdk; print('SDK installed successfully')"

Private Repository Setup

If your development environment has no internet access, host the SDK in a private repository:

Java

Upload the JAR to your private Maven repository (Nexus, Artifactory, etc.), then configure the repository URL in pom.xml:

<repositories>
  <repository>
    <id>private-repo</id>
    <url>https://your-maven-repo/repository/maven-releases/</url>
  </repository>
</repositories>

Python

Upload the SDK source to a private PyPI server, then install from that index:

pip install idmp-sdk --index-url https://your-pypi-server/simple/