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

# Quick Setup Guide

Get up and running in minutes using create-hedra-avatar.

> **⚠️ Before you begin:**
> Please make sure you have completed the [Get Started](./get-started) section first to set up all required API keys and environment variables.

***

1. **Create your application (replace \<app-name> with your desired name):**

```sh theme={null}
npx @hedra/create-hedra-avatar <app-name>
```

> **Note:** Make sure you have `pnpm` installed:

```sh theme={null}
# Homebrew
brew install pnpm
# or
npm install -g pnpm
```

> You might need to use a virtual environment when installing dependencies using pip. You must use Python version >3.10. (If you change your Python version after creating a virtual environment, delete the `venv` directory and recreate it with the correct Python version)

```sh theme={null}
python3 -m venv venv
source venv/bin/activate
```

> If you see an error about a missing dependency you can now install it with `pip`:

```sh theme={null}
# Example
pip install dotenv
```

2. **Navigate to your application directory:**

```sh theme={null}
cd <app-name>
```

3. **Create `.env.local` in both frontend and backend directories and copy the contents of the `.env` file created earlier:**

```sh theme={null}
cp ~/<path-to-your-env-file>/.env ./frontend/.env.local
cp ~/<path-to-your-env-file>/.env ./backend/.env.local
```

4. **Start the agent:**

```sh theme={null}
npm run start-agent
```

5. **Start the application (in a new terminal with the same virtual environment activated):**

```sh theme={null}
npm run start-app
```

> **Note:** Make sure you have Node.js installed:

```sh theme={null}
brew install node
```

> Install any missing packages:

```sh theme={null}
npm install
```