tinker-cli

Automate Tinker training runs and checkpoint management via CLI, including HuggingFace Hub publishing.

4.0k|507|Updated Jul 14, 2025
One-click install
npx skills add https://github.com/thinking-machines-lab/tinker-cookbook --skill tinker-cli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tinker-cli
Source: https://github.com/thinking-machines-lab/tinker-cookbook/tree/main/.claude/skills/tinker-cli
Command: npx skills add https://github.com/thinking-machines-lab/tinker-cookbook --skill tinker-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Managing, auditing, and provisioning training runs and checkpoints for LLM fine-tuning via a CLI can be scattered across docs and manual steps; this guide centralizes CLI usage.

Core Features & Use Cases

  • Manage training runs: list, info, and filter runs from the terminal.
  • Manage checkpoints: list, download, publish or unpublish checkpoints.
  • Publish to HuggingFace Hub: push checkpoints or models directly from the CLI.
  • Quick automation: script common workflows for batch fine-tuning and deployment.

Quick Start

Run tinker run list to view recent training runs.

Frequently Asked Questions about tinker-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list and inspect Tinker training runs from the CLI?

You can list and inspect Tinker training runs from the CLI by executing commands like 'tinker run list' to view recent runs and 'tinker run info' to retrieve specific run details, allowing you to filter and audit runs directly from the terminal.

Can I download and publish LLM checkpoints to HuggingFace Hub using the terminal?

Yes, you can download and publish LLM checkpoints to HuggingFace Hub using the terminal by utilizing Tinker CLI commands to push checkpoints directly to the HF Hub, streamlining the model publishing workflow.

Do I need a TINKER_API_KEY to manage training checkpoints via CLI?

Yes, you need a TINKER_API_KEY to manage training checkpoints via CLI. The environment variable must be set to authenticate your session before you can list, download, or publish checkpoints.

How do I automate batch fine-tuning workflows using CLI commands?

You automate batch fine-tuning workflows by scripting standard CLI commands for runs and checkpoints. This allows you to automate repetitive tasks like listing, downloading, and publishing models for deployment.

What is the best way to audit LLM fine-tuning runs without leaving the terminal?

The best way to audit LLM fine-tuning runs without leaving the terminal is using the Tinker CLI to centralize run management. It provides commands to list, inspect, and filter runs, replacing scattered manual documentation.