Getting the SDK

Source access, package downloads and more.

As part of your Talent Agent SDK subscription you'll receive source access to the full SDK source code and samples at https://github.com/peoplelogic/agent-sdk. We will have invited your organization as a collaborator during signup.

The preferred method of starting a new project with the SDK is to leverage Gradle or Maven as your build tool.

build.gradle

plugins {
    id 'java'
    id "io.freefair.lombok" version "8.6"
    id "org.springframework.boot" version "3.5.3"
}

group = 'dev.peoplelogic.agents.sample'
project.description = "Peoplelogic Agent SDK Sample"
def agent_sdk_version = "${agent_sdk_version}"

java { toolchain { languageVersion = JavaLanguageVersion.of(17) } }
repositories {
    mavenCentral()
    maven { url 'https://jitpack.io' }
    maven {
        name = "SDK Repository"
        url = uri("https://maven.pkg.github.com/peoplelogic/agent-sdk")
        credentials {
            username = System.getenv("GITHUB_USERNAME") ?: project.findProperty("github.username")
            password = System.getenv("GITHUB_PACKAGES_TOKEN") ?: project.findProperty("github.packagesToken")
        }
    }
}

dependencies {
    implementation(platform("ai.peoplelogic:agent-sdk-dependencies:${agent_sdk_version}"))
    // Include teh SDK
    implementation "ai.peoplelogic:agent-sdk"
    implementation "dev.langchain4j:langchain4j"
}

pom.xml

<project xmlns="http://maven.apache.org/POM/4.0.0" 
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
                             https://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <!-- Inherit Spring Boot’s plugin and dependency-management settings -->
  <parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>${spring.boot.version}</version>
    <relativePath/> <!-- lookup parent from repository -->
  </parent>

  <groupId>dev.peoplelogic.agents.sample</groupId>
  <artifactId>agent-sdk-sample</artifactId>
  <version>0.0.1-SNAPSHOT</version>
  <name>Peoplelogic Agent SDK Sample</name>
  <description>Peoplelogic Agent SDK Sample</description>

  <properties>
    <!-- pulled in from your Space variables -->
    <java.version>17</java.version>
    <lombok.version>8.6</lombok.version>
    <spring.boot.version>3.5.3</spring.boot.version>
    <agent.sdk.version>1.0.8-RC1</agent.sdk.version>

    <!-- for GitHub Packages auth -->
    <github.username>${env.GITHUB_USERNAME}</github.username>
    <github.packagesToken>${env.GITHUB_PACKAGES_TOKEN}</github.packagesToken>
  </properties>

  <repositories>
    <repository>
      <id>maven-central</id>
      <url>https://repo.maven.apache.org/maven2/</url>
    </repository>
    <repository>
      <id>jitpack.io</id>
      <url>https://jitpack.io</url>
    </repository>
    <repository>
      <id>sdk-repository</id>
      <name>SDK Repository</name>
      <url>https://maven.pkg.github.com/peoplelogic/agent-sdk</url>
      <releases><enabled>true</enabled></releases>
      <snapshots><enabled>true</enabled></snapshots>
      <authentication>
        <username>${github.username}</username>
        <password>${github.packagesToken}</password>
      </authentication>
    </repository>
  </repositories>

  <dependencyManagement>
    <dependencies>
      <!-- import the agent‑sdk BOM so you can omit explicit versions -->
      <dependency>
        <groupId>ai.peoplelogic</groupId>
        <artifactId>agent-sdk-dependencies</artifactId>
        <version>${agent.sdk.version}</version>
        <type>pom</type>
        <scope>import</scope>
      </dependency>
    </dependencies>
  </dependencyManagement>

  <dependencies>
    <!-- platform BOM already imported -->
    <dependency>
      <groupId>ai.peoplelogic</groupId>
      <artifactId>agent-sdk</artifactId>
    </dependency>

    <dependency>
      <groupId>dev.langchain4j</groupId>
      <artifactId>langchain4j</artifactId>
    </dependency>

    <!-- Lombok (annotation‑only) -->
    <dependency>
      <groupId>org.projectlombok</groupId>
      <artifactId>lombok</artifactId>
      <version>${lombok.version}</version>
      <scope>provided</scope>
    </dependency>

    <!-- Spring Boot test support, etc., can go here if needed -->
  </dependencies>

  <build>
    <plugins>
      <!-- Compile with Java toolchain version -->
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>3.10.1</version>
        <configuration>
          <release>${java.version}</release>
        </configuration>
      </plugin>

      <!-- Spring Boot repackage & run -->
      <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
        <configuration>
          <jvmArguments>
            -Xmx2g
            --add-opens=java.base/jdk.internal.ref=ALL-UNNAMED
            --add-opens=java.base/java.lang=ALL-UNNAMED
            --add-opens=java.base/java.lang.reflect=ALL-UNNAMED
            --add-opens=java.base/sun.reflect.annotation=ALL-UNNAMED
          </jvmArguments>
        </configuration>
      </plugin>
    </plugins>
  </build>
</project>

If you're using Gradle, you'll also typically want to include a gradle.properties file with the following:

gradle.properties

agent_sdk_version = 1.0.8-RC1

Alternatives to Gradle or Maven

If you aren't a user of Gradle or Maven, you can download the SDK as a standalone package to include in your project or you can download one of our sample projects as a starter kit.

PreviousGetting Started with the Talent Agent SDK NextClasses of Agents

Last updated 3 months ago

Was this helpful?