# init (private)

Creates a new Paperspace app. This command creates a new directory with a default app structure. You can optionally specify a name for the app and a template to use. If no template is specified, the default template is used.

Creates a new app in the current directory.

```
$ pspace init
```

Create a new app named “my-app” relative to the current directory.

```
$ pspace init my-app
```

Create a new app named “my-app” relative to the current directory using a template from the Paperspace GitHub organization.

```
$ pspace init my-app -t Paperspace/gradio-demo
```

## Arguments

The directory to create the app in. Defaults to the current directory.

### \[argument] (string, required)

## Flags

### –template, -t (string, required)

A template to use when creating the app. This can be a URL to a git repository or a shorthand template name.

These templates are equivalent:

- `user/repo`
- `github:user/repo`
- `git@github.com:user/repo`
- `https://github.com/user/repo`

Download from GitLab:

- `gitlab:user/repo`
- `git@gitlab.com:user/repo`
- `https://gitlab.com/user/repo`

Download from Bitbucket

- `bitbucket:user/repo`
- `git@bitbucket.org:user/repo`
- `https://bitbucket.org/user/repo`

Specify a tag or branch:

- `user/repo#dev # branch`
- `user/repo#v1.2.3 # release tag`
- `user/repo#1234abcd # commit hash`

### mode, -m (string, optional)

The mode to use when creating the app. This can be either “git” or “tar”. If “git” is specified, the template is downloaded as a tarball. “git” clones over SSH, so you must have a valid SSH key configured with GitHub, Bitbucket, or GitLab. One of `git` or `tar`.

### name, -n (string, optional)

The name of the app. Defaults to the first argument current directory name.

### clean, -c (boolean, optional)

Clean the Paperspace cache. This negates other args/flags.

## Global Flags

These flags are available on all commands.

### –log-level, -l (string, optional)

Enable debug logging. One of `debug`, `info`, `warning`, `error`, or `critical`.

### –json, -j (boolean, optional)

Output JSON

### –api-key (string, optional)

A Paperspace public API Key used for authenticating requests

### –help, -h (boolean, optional)

Show help for a command