index

环境要求

• Python 环境（需可执行 pip 命令）
• 至少一个模型 API Key：Gemini / Anthropic / OpenAI
• 能访问 pip 源与 Playwright 浏览器下载源
• 本地安装 Chrome 浏览器（仅使用 --local-chrome 模式时需要）

安装与启动步骤

1. 1安装 Index 包

   用 pip 安装 lmnr-index 及 lmnr 全部依赖。README 指定包名为 lmnr-index，注意别装错名字。

   pip install lmnr-index 'lmnr[all]'

   复制

2. 2安装 Chromium

   Index 基于 Playwright 驱动浏览器，必须单独安装 Chromium 内核，否则启动时会报找不到浏览器。

   playwright install chromium

   复制

3. 3配置模型密钥

   在项目根目录新建 .env 文件，按需填入 Gemini、Anthropic、OpenAI 的 API Key，键名必须与 README 一致。

   GEMINI_API_KEY=sk-xxxxxxxx
   ANTHROPIC_API_KEY=sk-ant-xxxxxxxx
   OPENAI_API_KEY=sk-xxxxxxxx

   复制

4. 4启动交互 CLI

   执行 index run 进入交互模式，按提示选择模型（1 Gemini 2.5 Flash、2 Claude 3.7 Sonnet、3 OpenAI o4-mini），再用自然语言下达任务。

   index run

   复制

5. 5复用本地 Chrome

   如果希望沿用自己 Chrome 中已登录的账号会话，加 --local-chrome 参数，默认使用系统默认 Chrome 路径。

   index run --local-chrome

   复制

6. 6代码中集成

   也可作为 Python 库调用。README 只展示了导入部分与 Pydantic 结构化输出思路，完整调用示例请以仓库文档为准。

   import asyncio
   from index import Agent, GeminiProvider
   from pydantic import BaseModel
   from lmnr import Laminar
   import os

   复制

关键配置

如何确认成功

执行 index run 后出现 Interactive Mode 文本界面并提示 Loaded existing browser state，输入指令后能看到 Step 1、Step 2 等实时执行步骤，即启动成功。

常见问题

注意事项

• .env 文件应放在项目根目录，README 未说明其他位置。
• Index 用 Playwright 驱动浏览器，务必先执行 playwright install chromium。
• API Key 属于敏感信息，不要提交到 Git 仓库或公开分享。
• 项目处于快速迭代阶段，命令与参数可能随版本变化，以仓库最新文档为准。