SDKs

Native Freeplay SDKs for Python, TypeScript, and Java/Kotlin.

Freeplay provides native SDKs for the most popular development languages. Each SDK offers the same core functionality with language-idiomatic interfaces.

Using Claude Code or Cursor? Check out the experimental Freeplay MCP server, skills, and plugin to interact with Freeplay directly from your editor through natural language.

Available SDKs

Python

pip install freeplay

PyPI · GitHub

TypeScript

npm install freeplay

npm · GitHub

Java/Kotlin

ai.freeplay:client

Maven Central

Core Capabilities

All SDKs provide:

• Prompt Management: Fetch and format prompts from Freeplay with variable interpolation
• Observability: Record sessions, traces, and completions automatically
• Testing: Create and execute test runs programmatically
• Feedback: Capture customer feedback on completions and traces

Getting Started

For detailed setup instructions, configuration options, and usage examples, see the SDK documentation:

SDK Documentation

Complete guide to installing and configuring the Freeplay SDK

SDK vs Framework Integrations

If you’re using LangGraph, Vercel AI SDK, Google ADK, or other AI frameworks that emit clean OTel traces, consider our framework integrations or Open Telemetry (OTel) for automatic observability with minimal code changes.

Feature	Freeplay SDK	Framework Integrations
Direct LLM control	Yes	Handled by framework
Automatic tracing	Manual	Automatic
Prompt management	Full support	Full support
Framework required	No	Yes (LangGraph, Vercel, etc.)
Best for	Custom integrations	Framework-specific projects