---
id: langsmith-fetch
version: "0.3.1"
license: unclear
license_treatment: unclear
maintenance: aging
---

# langsmith-fetch — LangSmith Fetch - Minimal CLI for fetching LangSmith threads and traces

License: unclear · Maintenance: aging · Downloads: 83.7K/mo

## What it is and what it does

LangSmith Fetch is a command-line tool for exporting traces and threads from LangSmith projects. It wraps the LangSmith API to let you bulk-download recent execution data or retrieve specific items by ID, saving them as JSON files or printing them to stdout. The tool is built on click, requests, and rich for a polished CLI experience, and integrates with python-dotenv for environment-based configuration.

You use it primarily for testing and debugging—pulling real LangSmith data locally to inspect, validate, or feed into other tools. It supports filtering by time range, customizable output formats (pretty, JSON, raw), and concurrent fetching. Configuration is minimal: set your API key and project name as environment variables, and the tool handles the rest, including automatic project UUID lookup and caching.

Use it for:

- Export recent traces from a LangSmith project to a local directory for offline inspection and debugging.
- Fetch a specific trace or thread by ID and pretty-print it to stdout for quick inspection during development.
- Bulk-download traces with metadata and feedback for integration into test suites or validation pipelines.
- Use as a programmatic data source for code agents that need to retrieve LangSmith execution history.
- Filter and export traces from the last N minutes or since a specific timestamp for incident analysis.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A CLI tool for fetching traces and threads from LangSmith projects, designed for testing, debugging, and programmatic data export by humans or code agents.

Yes, if you actively use LangSmith and need a quick way to export traces and threads for testing or debugging. The low install friction and straightforward CLI make it easy to adopt. However, the aging maintenance status (no updates in 245 days) and unclear license warrant verification before use in production or proprietary contexts. No known security vulnerabilities.

## Install

pip install langsmith-fetch
uv add langsmith-fetch
poetry add langsmith-fetch

## Installing langsmith-fetch

Before you install: Low install friction with six common runtime dependencies. Maintenance status is aging—the package has not been updated since its initial release 245 days ago, which may indicate limited ongoing support or that it has reached a stable endpoint.

License in practice: License treatment is unclear; no SPDX identifier or raw license text is available in the metadata. Verify the actual license before use in proprietary or restricted contexts.

Quickstart:

pip install langsmith-fetch
export LANGSMITH_API_KEY=lsv2_...
export LANGSMITH_PROJECT=your-project-name
langsmith-fetch traces ./my-traces --limit 10

Requires Python >=3.10 and valid LangSmith API credentials (LANGSMITH_API_KEY and LANGSMITH_PROJECT environment variables).

Verify before relying:

- Whether the package is actively maintained or has reached a stable, feature-complete state despite no updates in 245 days.
- Actual license terms, since license_treatment is marked unclear and no SPDX or raw license text is provided.
- Whether the 71 tests mentioned in the description are actually present and passing in the current release.

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 83.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

langsmith data export cli, fetch traces threads langsmith, langsmith debugging tool, langsmith project data retrieval, langsmith cli fetcher, export langsmith traces, langsmith thread export, langsmith-integration, cli-tool, debugging

[View on SkillFed](https://skillfed.io/packages/langsmith-fetch) · [View on PyPI](https://pypi.org/project/langsmith-fetch/)