How to set up a Java application

This guide covers the basic configuration files needed to use the LangSmith Java SDK in your application.

Specify dependencies

Dependencies can be specified using either Maven or Gradle. The LangSmith Java SDK requires Java 8 or later.

Maven

Add the LangSmith Java SDK to your pom.xml:

<dependency>
  <groupId>com.langchain.smith</groupId>
  <artifactId>langsmith-java</artifactId>
  <version>0.1.0-alpha.19</version>
</dependency>

Gradle

Add the LangSmith Java SDK to your build.gradle.kts or build.gradle:

implementation("com.langchain.smith:langsmith-java:0.1.0-alpha.19")

Example file directory:

my-app/
└── build.gradle.kts # Gradle dependencies

Specify environment variables

The LangSmith Java SDK configures itself through environment variables. See the Environment Variables reference to configure additional variables for tracing. Example .env file:

# Required: LangSmith API Key
LANGSMITH_API_KEY=lsv2_...

# Optional: Custom LangSmith API endpoint
# LANGSMITH_ENDPOINT=https://api.smith.langchain.com

# Optional: Organization and tenant settings
# LANGSMITH_ORGANIZATION_ID=your-org-id
# LANGSMITH_TENANT_ID=your-tenant-id

The SDK will automatically read these environment variables when you initialize the client using LangsmithOkHttpClient.fromEnv(). Example file directory:

my-app/
├── pom.xml # or build.gradle.kts
└── .env # environment variables

After you configure your Java application with the LangSmith SDK, you can:

Edit this page on GitHub or file an issue.

Connect these docs to Claude, VSCode, and more via MCP for real-time answers.

How to set up a JavaScript application

Monorepo support

Configure app for deployment

Deployment guides

App development

Studio

Auth & access control

Server customization

How to set up a Java application

Specify dependencies

Maven

Gradle

Specify environment variables

Next

​Specify dependencies

​Maven

​Gradle

​Specify environment variables

​Next

Specify dependencies

Maven

Gradle

Specify environment variables

Next