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

# 为新用户设置工作空间

请按照以下步骤设置现有工作空间：

<Steps>
  <Step title="克隆 git 仓库">
    克隆 git 仓库并 `cd` 进入工作空间目录

    <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="创建并激活虚拟环境">
    <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="安装 agno">
    <CodeGroup>
      ```bash Mac theme={null}
      pip install -U agno
      ```

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

  <Step title="设置工作空间">
    <CodeGroup>
      ```bash Mac theme={null}
      ag ws setup
      ```

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

  <Step title="复制敏感信息">
    将 `workspace/example_secrets` 复制到 `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="启动工作空间">
    <Note>
      如果需要，请安装 [docker desktop](https://docs.docker.com/desktop/install/mac-install/)。
    </Note>

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

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

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

  <Step title="停止工作空间">
    <CodeGroup>
      ```bash terminal theme={null}
      ag ws down
      ```

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

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