---
title: "arkor init"
description: "Add Arkor to an existing project."
---

Drops Arkor's starter files into your current directory: a [Trainer](/docs/framework/concepts/trainer) under `src/arkor/`, an `arkor.config.ts`, and a `dev` / `build` / `start` script trio in your `package.json`.

Use it from inside a directory you already own. For greenfield projects, use `<pm> create arkor` instead. See [Quickstart](/docs/framework/quickstart).

## Run it

<CodeGroup labels={["pnpm","npm","yarn","yarn-berry","bun"]}>

```bash
pnpm arkor init
```

```bash
npm arkor init
```

```bash
yarn arkor init
```

```bash
yarn run arkor init
```

```bash
bun arkor init
```

</CodeGroup>

The command asks for a project name, picks a starter template, optionally runs `git init`, then installs dependencies. Take the defaults to get something working fast; come back later to customize.

## Then what

Once init finishes, the next step is:

<CodeGroup labels={["pnpm","npm","yarn","bun"]}>

```bash
pnpm dev
```

```bash
npm run dev
```

```bash
yarn dev
```

```bash
bun dev
```

</CodeGroup>

Studio boots at `http://127.0.0.1:4000`. From there you can trigger a training run.

## Reference

For all flags, error messages, package-manager detection rules, and the exact list of files written, see the [`arkor init` reference](/docs/framework/cli/init).