tinker_cookbook

What it is and what it does

Tinker Cookbook is a library of recipes and utilities built on top of the Tinker API—a managed fine-tuning service for language models. It abstracts away distributed training complexity by letting you send API requests to Thinking Machines Lab's infrastructure rather than managing training yourself. The package includes realistic, runnable examples for common post-training workflows: supervised fine-tuning on conversational data, reinforcement learning for math and code, preference learning (DPO and RLHF), knowledge distillation, tool-use training, multi-agent RL, audio and vision-language model training, and more.

You install it alongside its 19 runtime dependencies (torch, transformers, datasets, huggingface-hub, and others) and then import recipes or utilities to configure and launch training jobs. The package also ships an experimental benchmark framework to evaluate trained models against 12 standard benchmarks, plus utilities for hyperparameter scaling, token-to-chat-message rendering, and weight management. All of this assumes you have a Tinker API account and an API key.

Use it for

• Fine-tune an open-source LLM like Llama on your own conversational dataset using supervised learning without managing distributed training infrastructure.
• Train a model to solve math problems with verifiable rewards using the math RL recipe with automated grading.
• Build a code-generation model using competitive programming examples and sandboxed execution (DeepCoder-style) via the code RL recipe.
• Implement a three-stage RLHF pipeline (SFT, reward model, RL) for preference-aligned models using the preference learning recipe.
• Evaluate a fine-tuned model against standardized benchmarks (GSM8K, MMLU-Pro, IFEval, etc.) using the built-in evaluation framework.
• Train a vision-language model for image classification or an audio model for speech recognition using the multimodal recipes.

Worth the install?

AI-flagged interpretation of the facts on this page. Verify before relying on it.

Install

tinker-cookbook on PyPI

Before you install

Low friction installation as a pure-Python wheel. Active maintenance with a recent release (3 days old) and strong repository signals (4019 stars, last commit 2026-08-14). Requires Python >=3.11 and pulls in 19 runtime dependencies including torch, transformers, and datasets—a substantial but expected footprint for LLM tooling.

Requires a Tinker API account and TINKER_API_KEY environment variable; torch>=2.10 is required for Inkling model support.

License in practice

Licensed under Apache-2.0 (permissive), allowing commercial use, modification, and distribution with minimal restrictions. No notable licensing friction for most use cases.

Quickstart

# Install
pip install tinker-cookbook

# Set up API key
export TINKER_API_KEY="your_key_here"

# Basic supervised learning example
import tinker
from tinker_cookbook.recipes.sl_basic import create_sl_trainer

service_client = tinker.ServiceClient()
training_client = service_client.create_lora_training_client(
    base_model="meta-llama/Llama-3.2-1B", rank=32
)
training_client.forward_backward(...)
training_client.optim_step(...)

Package facts

Evidence: tinker_cookbook-0.5.4-py3-none-any.whl

Tags

More Artificial Intelligence packages

See also tinker · trl · torchtune · gem-llm · google-tunix · verl · ms-swift · skrl · torchrl · reasoning-gym

Further reading