Installation

Install MutagenT tools for your development environment.

CLI (Recommended)

The CLI is the primary developer interface for MutagenT. It handles authentication, framework integration, and trace management.

bun add -g @mutagent/cli

npm install -g @mutagent/cli

Verify Installation

mutagent --version
# @mutagent/cli v0.1.186

Authenticate

After installing, log in to connect the CLI to your MutagenT account. The CLI presents two authentication methods interactively: browser-based OAuth or pasting an API key.

mutagent auth login

You can also specify the authentication method directly:

# Browser-based OAuth flow
mutagent auth login --browser

# Direct API key (for CI/CD pipelines)
export MUTAGENT_API_KEY=mt_xxxxxxxxxxxx
# OR use non-interactive mode:
mutagent auth login --non-interactive

Check your authentication status at any time:

mutagent auth status

For CI/CD environments, set the MUTAGENT_API_KEY environment variable (no login needed). The CLI also respects CI=true and MUTAGENT_NON_INTERACTIVE=true to auto-select browser auth.

See CLI Documentation for full details.

SDK (Optional)

The SDKs provide programmatic access for advanced use cases: direct API access, custom integrations, or scripting.

TypeScript
Python

The TypeScript SDK (@mutagent/sdk v0.2.137):

bun add @mutagent/sdk

npm install @mutagent/sdk

yarn add @mutagent/sdk

pnpm add @mutagent/sdk

import { Mutagent } from '@mutagent/sdk';

const client = new Mutagent({
  security: { apiKey: process.env.MUTAGENT_API_KEY },
});

console.log('MutagenT TypeScript SDK installed successfully');

The Python SDK (mutagent-sdk v0.1.1) — requires Python 3.10+:

pip install mutagent-sdk

from mutagent import Mutagent

client = Mutagent()  # reads MUTAGENT_API_KEY from environment
print('MutagenT Python SDK installed successfully')

See the Python SDK Installation guide for full setup.

Integration Packages

Most developers use integration packages that auto-trace LLM framework calls. Install the one matching your framework.

TypeScript
Python

bun add @mutagent/langchain

bun add @mutagent/langgraph

bun add @mutagent/openai

# @mutagent/mastra is not yet published — coming soon
# bun add @mutagent/mastra

bun add @mutagent/vercel-ai

You do not need to install integration packages manually if you use mutagent integrate. The CLI generates the integration code and tells you which package to install.

Environment Variables

Variable	Purpose	Default
`MUTAGENT_API_KEY`	API key for authentication (SDK and CLI)	—
`MUTAGENT_ENDPOINT`	Custom API endpoint	`https://api.mutagent.io`
`MUTAGENT_DEBUG`	Enable debug logging for span start/end events	No
`MUTAGENT_NON_INTERACTIVE`	Set to `true` to skip interactive prompts	`false`

System Requirements

TypeScript / Node.js

Requirement	Version
Node.js	18.0+
Bun	1.0+
TypeScript	5.0+ (recommended)

Python

Requirement	Version
Python	3.10+

​Installation

​CLI (Recommended)

​Verify Installation

​Authenticate

​SDK (Optional)

​Integration Packages

​Environment Variables

​System Requirements

​TypeScript / Node.js

​Python

Installation

CLI (Recommended)

Verify Installation

Authenticate

SDK (Optional)

Integration Packages

Environment Variables

System Requirements

TypeScript / Node.js

Python