installation.md

sidebar_position	1
description	安装 NoneBot CLI
options	menu category weight guide 10

安装

环境要求

NoneBot CLI 仅支持 Python 3.10 以上版本。

通过 pipx 安装

pipx 是专为 Python CLI 应用设计的工具，实现了 CLI 应用的环境隔离。同时，pipx 也会接管 NoneBot CLI 及其依赖的升级与卸载。

请参考 pipx 文档 来安装 pipx。

pipx install nb-cli

pipx upgrade nb-cli

pipx uninstall nb-cli

通过 uv tool 安装

uv (by Astral) 是一个飞快的 Python 包与项目管理器，使用 Rust 语言编写。其也拥有工具集成管理的功能。

请参考 uv 文档 来安装 uv。

uvx --from nb-cli@latest nb

# 指定 Python 版本（如 3.12）
uvx -p 3.12 --from nb-cli@latest nb

uv tool install nb-cli@latest

# 指定 Python 版本（如 3.12）
uv tool install -p 3.12 nb-cli@latest

uvx --from nb-cli nb
# 或
uv tool run --from nb-cli nb

uv tool upgrade nb-cli

uv tool uninstall nb-cli