# gt: General Translation CLI tool: Setup Wizard
URL: https://generaltranslation.com/en-GB/docs/cli/init.mdx
---
title: Setup Wizard
description: Run the GT setup wizard
---

## Usage

```bash
npx gt init
```

Use this command to run the GT setup wizard.

This command is equivalent to running `setup` and then `configure`.

The wizard will:

1. Install the necessary dependencies for your project.
2. (If Next.js) Add the `withGTConfig` function to your `next.config.js` file and set up the `GTProvider` component.
3. Create a `gt.config.json` file at the root of your project.
4. Generate an API key and project ID for your project.


## Dependencies

The `init` command will install the following dependencies for your project:

* `gt-react` or `gt-next` (if your project is React-based)
* `gt` as a dev dependency (if not already installed)

## React-based projects

If your project is React-based, the wizard will help set up your project to use `gt-react` or `gt-next`.

If you are already using a different i18n library, you may need to set up your project manually.

See the [React docs](/docs/react) or the [Next.js docs](/docs/next) for more information.

Since the wizard is currently experimental, it may not work for all React-based projects.
In these cases, you may need to set up your project manually.

If you run into any issues, please let us know on [GitHub](https://github.com/generaltranslation/gt/issues).

This part of the wizard can also be run independently via `npx gt setup`.

## `gt.config.json`

The `init` command helps you configure your project's GT settings.

It creates a `gt.config.json` file in the root of your project.

The file contains the following settings:

* `defaultLocale`: The default locale for your project.
* `locales`: An array of [supported locales](/docs/platform/supported-locales) for your project.
* `files`: An object containing information about the content you want to translate.

For more detailed information about the `gt.config.json` file, see the [config docs](/docs/cli/reference/config).

You can also run this part of the wizard independently with `npx gt configure`.

## Credentials

The wizard will help you generate an API key and project ID for your project (if they are not already set up).

Please note that you do not need an API key or project ID to use `gt-react` or `gt-next`.

The wizard will add the API key and project ID to your `.env.local` file.
If this file does not exist, the wizard will create it and add it to your `.gitignore` file.

This part of the wizard can also be run separately with `npx gt auth`.