> ## Documentation Index
> Fetch the complete documentation index at: https://starforge.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# sf new

> Create an experiment

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
sf new my-grpo --method nemo-rl/grpo
```

创建 `experiments/my-grpo/`，里面三个文件：

| 文件                 | 是什么                    |
| ------------------ | ---------------------- |
| `config.yaml`      | 方法模板，最常改的几个键放在最上面      |
| `README.md`        | 你对这个实验的记录              |
| `recipe.lock.json` | 这个实验锁定的确切 recipe 与框架版本 |

然后改 `config.yaml`，跑 [`sf validate`](/zh-Hans/cli/validate)。

## 从已有实验 fork

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
sf new my-grpo-v2 --from my-grpo
```

复制配置和锁文件。给了 `--from` 时 `--method` 会被忽略——fork 按定义就继承原实验的方法。

## 固定框架版本

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
sf new my-verl --method verl/grpo --framework-version 0.9.0
```

必须是 catalog 为该方法发布过的版本。用 [`sf methods`](/zh-Hans/cli/methods) 查。

## `sf new`

Create an experiment

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
sf new <NAME> [options]
```

| 参数     | 说明                       |
| ------ | ------------------------ |
| `NAME` | Experiment name (**必填**) |

| 选项                    | 说明                                                                                                                         |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| `--from`              | Fork an existing experiment                                                                                                |
| `--method`, `-m`      | Method identifier \<framework>/\<method>; defaults to nemo-rl/grpo, run `sf methods` for the full list (默认 `nemo-rl/grpo`) |
| `--framework-version` | Exact framework version; must be a version published in the recipe catalog                                                 |