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

# Install & Setup

## Install phidata

We highly recommend:

* Installing `phidata` using `pip` in a python virtual environment.
* Creating an `ai` directory for your ai workspaces

<Steps>
  <Step title="Create a virtual environment">
    Open the `Terminal` and create an `ai` directory with a python virtual environment.

    <CodeGroup>
      ```bash Mac theme={null}
      mkdir ai && cd ai

      python3 -m venv aienv
      source aienv/bin/activate
      ```

      ```bash Windows theme={null}
      mkdir ai; cd ai

      python3 -m venv aienv
      aienv/scripts/activate
      ```
    </CodeGroup>
  </Step>

  <Step title="Install phidata">
    Install `phidata` using pip

    <CodeGroup>
      ```bash Mac theme={null}
      pip install -U phidata
      ```

      ```bash Windows theme={null}
      pip install -U phidata
      ```
    </CodeGroup>
  </Step>

  <Step title="Install docker">
    Install [docker desktop](https://docs.docker.com/desktop/install/mac-install/) to run apps locally
  </Step>
</Steps>

<br />

<Note>
  If you encounter errors, try updating pip using `python -m pip install --upgrade pip`
</Note>

***

## Upgrade phidata

To upgrade `phidata`, run this in your virtual environment

```bash theme={null}
pip install -U phidata --no-cache-dir
```

***

## Setup workspace

If you have an existing `phidata` workspace, set it up using

```bash theme={null}
phi ws setup
```

***

## Reset phidata

To reset the phidata config, run

```bash theme={null}
phi init -r
```

<Note>
  This does not delete any physical data
</Note>