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

# 安装与设置

## 安装 Agno

我们强烈建议：

* 在 python 虚拟环境中，使用 `pip` 安装 `agno`。
* 创建一个 `ai` 目录来存放你的 ai 工作空间

<Steps>
  <Step title="创建虚拟环境">
    打开 `Terminal`，创建一个 `ai` 目录并设置一个 python 虚拟环境。

    <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="安装 Agno">
    使用 pip 安装 `agno`

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

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

  <Step title="安装 Docker">
    安装 [docker desktop](https://docs.docker.com/desktop/install/mac-install/) 以在本地运行 Apps。
  </Step>
</Steps>

<br />

<Note>
  如果遇到错误，请尝试更新 pip：`python -m pip install --upgrade pip`
</Note>

***

## 升级 Agno

要升级 `agno`，请在你的虚拟环境中运行此命令：

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

***

## 设置工作空间

如果你有一个已存在的 `agno` 工作空间，请使用以下命令进行设置：

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

***

## 重置 Agno

要重置 agno 配置，请运行：

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

<Note>
  这不会删除任何物理数据。
</Note>