notte

环境要求

• Python 环境（用于 pip 安装 notte）
• 可用的自有 LLM API 密钥（本地模式必须自备）
• 能联网下载 Chromium 浏览器（patchright 安装依赖）
• 可选：Node.js 环境（仅在用 JS/TS SDK 时需要）

安装与启动步骤

1. 1安装 Python SDK

   通过 pip 安装 notte 开源核心包，建议在虚拟环境中执行以免污染全局环境。

   pip install notte

   复制

2. 2安装浏览器依赖

   notte 依赖 patchright 驱动 Chromium，该命令会自动下载浏览器及系统依赖，耗时较长请耐心等待。

   patchright install --with-deps chromium

   复制

3. 3准备 LLM 密钥

   README 说明本地模式需要自备 LLM API 密钥，示例脚本用 dotenv 从 .env 读取，请把密钥写入项目目录下的 .env 文件。

4. 4运行本地 Agent 示例

   创建 Python 脚本并运行，会启动浏览器让 Agent 完成“在 Google 图片找三张猫表情包并描述”的任务，需保证 .env 已就绪。

   import notte
   import os
   from dotenv import load_dotenv
   load_dotenv()
   
   with notte.Session(headless=False) as session:
       model = os.getenv("NOTTE_EXAMPLE_MODEL", "gemini/gemini-2.5-flash")
       agent = notte.Agent(session=session, reasoning_model=model, max_steps=10)
       response = agent.run(task="Find three cat memes on Google Images and describe them")

   复制

5. 5可选安装 Node SDK

   如需在 JavaScript/TypeScript 项目中使用，README 提供了 Node SDK，直接通过 npm 安装即可。

   npm install notte-sdk

   复制

关键配置

如何确认成功

脚本运行无报错，headless=False 的浏览器窗口被打开并执行任务，最终返回对三张猫图的描述结果。

常见问题

注意事项

• 本地模式需要自备 LLM API 密钥，脚本使用 dotenv 从 .env 文件加载。
• 示例中 Session 使用 headless=False，会弹出可视化浏览器窗口，需要图形界面环境。
• 更多文档见 docs.notte.cc，云托管控制台为 console.notte.cc。