Skip to main content
Choose your language below, then send your first trace or let your coding agent set up Hue.

​
TypeScript

Requires Node.js 24. Run the command in your application’s directory. For a new example, create a directory and run npm init -y first.
The current package’s AI SDK 7 peer requirement conflicts with an installed ai@6, including core-only imports. Check compatibility before adding it to an existing application. An application already using OpenTelemetry can send data through its standard exporter.

​
Python

Requires Python 3.10 or later; tested on 3.10 and 3.14. Install into your project’s existing environment:
For a new pip example, create and activate a virtual environment first with python3 -m venv .venv and source .venv/bin/activate. For a new uv project, run uv init before uv add; run the examples with uv run python or activate its .venv. The SDK uses OpenTelemetry 1.44.0. See compatibility if your application already pins a different version.

​
Verify your installation

The documented releases are TypeScript 0.1.4 on npm and Python 0.1.2 on PyPI. Check the installed version with npm ls @hue-run/sdk or python -m pip show hue-run; in a uv project, use uv tree. Continue with the quickstart to check your key and send a trace. Both SDKs connect to Hue Cloud by default.