Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.together.ai/llms.txt

Use this file to discover all available pages before exploring further.

The Together CLI sends anonymous usage events that help Together AI understand how the CLI is used and prioritize fixes and features. Telemetry applies only when you use the tg command-line tool (also available as together). It is separate from the Python SDK’s behavior unless you invoke the CLI.

​
How to opt out

You can disable telemetry tracking by setting the TOGETHER_TELEMETRY_DISABLED environment variable, or by running tg telemetry disable, which saves the choice to a local configuration file on disk. 
TOGETHER_TELEMETRY_DISABLED=1 tg files upload ./data.jsonl
Use these commands to enable, disable, or check telemetry status:
CommandWhat it does
tg telemetry statusPrints whether telemetry is enabled or disabled, and notes when the environment variable is forcing it off.
tg telemetry disableDisables telemetry by updating the config file.
tg telemetry enableEnables telemetry by updating the config file.
Config file location:
  • macOS / Linux: $XDG_CONFIG_HOME/together/cli.json if XDG_CONFIG_HOME is set, otherwise ~/.config/together/cli.json.
  • Windows: %APPDATA%\Together\cli.json.
The same file also stores a generated UUID as a stable, pseudonymous device identifier. An example config file: 
{
  "telemetry_enabled": true,
  "device_id": "7ba688c9-7e39-460a-9c96-ac518ab65605"
}

​
What is tracked

The CLI collects the following data for every event:
FieldDescription
timestampMillisecond timestamp when the event was built.
session_idIdentifier for this CLI process, stable for the lifetime of the process.
device_idStable pseudonymous ID stored in cli.json when first needed. Together AI does not use any host-hardware fingerprinting.
metadataRuntime metadata such as the CLI version, operating system, and CPU architecture.
is_citrue if the CI environment variable is set.
agent_detectionFrom detect_agent. Records whether the command was invoked by an agent and which known agent.
commandThe name of the command invoked, for example clusters create.
arg_namesThe names of any CLI arguments passed in. Together AI does not collect their values. For example, if you pass --secret FOOBAR, only the argument name secret is recorded.