跳到正文
cccskills
免费在 GitHub 公开

setup

Guide for installing Tinker, setting up the environment, getting an API key, and verifying everything works. Use when the user is getting started, setting up their environment, or troubleshooting installation issues.

中文简介正在准备中。当前显示原文说明。

查看安装方法

包含的文件(1)

  • SKILL.md2.4 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

Setup & Installation

Get Tinker and tinker-cookbook running from scratch.

Reference

  • docs/install.mdx — Official installation guide
  • CONTRIBUTING.md — Development setup
  • README.md — Project overview

Step 1: Sign up and get an API key

  1. Sign up at https://auth.thinkingmachines.ai/sign-up
  2. Create an API key from the console
  3. Export it:
export TINKER_API_KEY=<your-key>

Add to your shell profile (.bashrc, .zshrc) for persistence.

Step 2: Install Tinker SDK

pip install tinker

This gives you:

  • Python SDK — TrainingClient, SamplingClient, low-level training/sampling APIs
  • Tinker CLI — tinker or python -m tinker for management tasks

Step 3: Install tinker-cookbook

git clone https://github.com/thinking-machines-lab/tinker-cookbook.git
cd tinker-cookbook
pip install -e .

Or with dev dependencies (for contributing):

uv sync --extra dev
pre-commit install

Step 4: Verify installation

import tinker
service_client = tinker.ServiceClient()
training_client = service_client.create_lora_training_client(
    base_model="meta-llama/Llama-3.2-1B", rank=32,
)
info = training_client.get_info()
print(info)  # Should print model info

Step 5: Run a minimal example

# Supervised learning
python -m tinker_cookbook.recipes.sl_basic

# Reinforcement learning
python -m tinker_cookbook.recipes.rl_basic

Environment variables

VariablePurpose
TINKER_API_KEYRequired — authenticates with Tinker service
HF_TOKENOptional — access gated HuggingFace models (Llama, etc.)
HF_TRUST_REMOTE_CODEOptional — allow custom tokenizer code
WANDB_API_KEYOptional — log to Weights & Biases

Common issues

  • TINKER_API_KEY not set: Export the key in your shell or .env file
  • Tokenizer download fails: Set HF_TOKEN for gated models (e.g., Llama)
  • Import errors: Ensure pip install -e . was run from the repo root
  • uv not found: Install with curl -LsSf https://astral.sh/uv/install.sh | sh

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

Guide for checkpointing — saving, loading, and resuming training with CheckpointRecord. Use when the user asks about saving weights, resuming training, checkpoint management, or the checkpoint lifecycle.

中文简介正在准备中。当前显示原文说明。

uiuc-kang-lab/rlvr_generalization_bounds52026年5月13日 更新

ci

免费

Guide for testing conventions and CI pipelines — unit tests, integration smoke tests, pytest markers, and GitHub Actions workflows. Use when the user asks about testing, CI, running tests, or adding tests for a recipe.

中文简介正在准备中。当前显示原文说明。

uiuc-kang-lab/rlvr_generalization_bounds52026年5月13日 更新

Guide for using completers — TokenCompleter and MessageCompleter for text generation during RL rollouts and evaluation. Use when the user asks about generating text, completing messages, or using completers in RL environments.

中文简介正在准备中。当前显示原文说明。

uiuc-kang-lab/rlvr_generalization_bounds52026年5月13日 更新

Guide for contributing to the tinker-cookbook repo — development setup, code style, type checking, PR process, and design conventions. Use when the user asks about how to contribute, set up the dev environment, code style, or project conventions.

中文简介正在准备中。当前显示原文说明。

uiuc-kang-lab/rlvr_generalization_bounds52026年5月13日 更新

datasets

免费

Guide for dataset construction — SupervisedDatasetBuilder, RLDatasetBuilder, ChatDatasetBuilder, and custom dataset creation from JSONL, HuggingFace, or conversation data. Use when the user asks about datasets, data loading, data preparation, or custom data formats.

中文简介正在准备中。当前显示原文说明。

uiuc-kang-lab/rlvr_generalization_bounds52026年5月13日 更新

Set up and run knowledge distillation (on-policy, off-policy, or multi-teacher) from a teacher model to a student model using the Tinker API. Use when the user wants to distill knowledge, compress models, or train a student from a teacher.

中文简介正在准备中。当前显示原文说明。

uiuc-kang-lab/rlvr_generalization_bounds52026年5月13日 更新

查看 uiuc-kang-lab 的全部技能

报告此技能的问题