2 分钟运行 Navi Agent

如果已准备好兼容 OpenAI 协议的 API Key，配置并启动 Navi Agent 约需 2 分钟。首次下载依赖的时间取决于网络状况，可能更长。

开始前准备

安装最新正式发布版本。安装脚本会在需要时自动配置 uv：

curl -fsSL https://raw.githubusercontent.com/xushun007/navi-agent/main/scripts/install.sh | sh

如果已经安装 uv，可以直接从 PyPI 安装：

uv tool install navi-agent

该命令安装的是最新发布到 PyPI 的版本，而不是当前 main 提交。后续升级正式版：

uv tool upgrade navi-agent

如需体验 main 上的最新开发版本，请显式选择：

uv tool install --force git+https://github.com/xushun007/navi-agent.git@main

再次执行该命令可更新开发版本；执行 uv tool install --force navi-agent 可回到受支持的正式发布渠道。

创建 ~/.navi-agent/config.yaml：

navi-agent init

编辑生成的配置文件，填写模型凭据：

model:
  name: gpt-4o-mini
  api_key: your-api-key
  base_url: https://api.openai.com/v1

检查配置：

navi-agent doctor

在项目目录中启动交互会话：

cd /path/to/your/project
navi-agent

或执行单次请求：

navi-agent "总结这个仓库"

navi-agent --add-dir ../shared

--add-dir 可以多次传入。