> ## 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.

# Setup workspace for new users

Follow these steps to setup an existing workspace:

<Steps>
  <Step title="Clone git repository">
    Clone the git repo and `cd` into the workspace directory

    <CodeGroup>
      ```bash Mac theme={null}
      git clone https://github.com/[YOUR_GIT_REPO].git

      cd your_workspace_directory
      ```

      ```bash Windows theme={null}
      git clone https://github.com/[YOUR_GIT_REPO].git

      cd your_workspace_directory
      ```
    </CodeGroup>
  </Step>

  <Step title="Create and activate a virtual env">
    <CodeGroup>
      ```bash Mac theme={null}
      python3 -m venv aienv
      source aienv/bin/activate
      ```

      ```bash Windows theme={null}
      python3 -m venv aienv
      aienv/scripts/activate
      ```
    </CodeGroup>
  </Step>

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

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

  <Step title="Setup workspace">
    <CodeGroup>
      ```bash Mac theme={null}
      phi ws setup
      ```

      ```bash Windows theme={null}
      phi ws setup
      ```
    </CodeGroup>
  </Step>

  <Step title="Copy secrets">
    Copy `workspace/example_secrets` to `workspace/secrets`

    <CodeGroup>
      ```bash Mac theme={null}
      cp -r workspace/example_secrets workspace/secrets
      ```

      ```bash Windows theme={null}
      cp -r workspace/example_secrets workspace/secrets
      ```
    </CodeGroup>
  </Step>

  <Step title="Start workspace">
    <Note>
      Install [docker desktop](https://docs.docker.com/desktop/install/mac-install/) if needed.
    </Note>

    <CodeGroup>
      ```bash terminal theme={null}
      phi ws up
      ```

      ```bash full options theme={null}
      phi ws up --env dev --infra docker
      ```

      ```bash shorthand theme={null}
      phi ws up dev:docker
      ```
    </CodeGroup>
  </Step>

  <Step title="Stop workspace">
    <CodeGroup>
      ```bash terminal theme={null}
      phi ws down
      ```

      ```bash full options theme={null}
      phi ws down --env dev --infra docker
      ```

      ```bash shorthand theme={null}
      phi ws down dev:docker
      ```
    </CodeGroup>
  </Step>
</Steps>