Index

Index 是一款顶尖的开源浏览器 Agent，能够自主执行复杂的网页任务。它将任何网站转化为可访问的 API，并可通过简单的几行代码实现无缝集成。

• 由具备视觉能力的推理型 LLM 提供驱动。
  • Gemini 2.5 Pro（速度极快且极其准确）
  • Claude 3.7 Sonnet（具备扩展思维能力，可靠且准确）
  • OpenAI o4-mini（根据推理深度，在速度、成本和准确性之间取得良好平衡）
  • Gemini 2.5 Flash（速度极快、成本低，适合较简单的任务）
• 支持 pip install lmnr-index 并在项目中直接使用
• 支持 index run 通过交互式 CLI 运行 Agent
• 支持通过 Pydantic 模式进行结构化输出，确保数据提取的可靠性。
• Index 同时提供 Serverless API。
• 您还可以通过 Chat UI 体验 Index。
• 支持由开源平台 Laminar 提供驱动的高级 浏览器 Agent 可观测性。

提示词示例：go to ycombinator.com. summarize first 3 companies in the W25 batch and make new spreadsheet in google sheets.

https://github.com/user-attachments/assets/2b46ee20-81b6-4188-92fb-4d97fe0b3d6a

文档

点击此处查看完整文档。

快速上手

安装依赖

pip install lmnr-index 'lmnr[all]'

# 安装 playwright
playwright install chromium

设置模型 API Key

在项目根目录的 .env 文件中设置您的模型 API Key：

GEMINI_API_KEY=
ANTHROPIC_API_KEY=
OPENAI_API_KEY=
# 可选：用于追踪 Agent 操作并记录浏览器会话
LMNR_PROJECT_API_KEY=

在代码中运行 Index

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

# 用于追踪 Agent 操作并记录浏览器会话
Laminar.initialize()

# 定义用于结构化输出的 Pydantic 模式
class NewsSummary(BaseModel):
    title: str
    summary: str

async def main():

    llm = GeminiProvider(model="gemini-2.5-pro-preview-05-06")
    agent = Agent(llm=llm)

    # 获取结构化输出的示例
    output = await agent.run(
        prompt="Navigate to news.ycombinator.com, find a post about AI, extract its title and provide a concise summary.",
        output_model=NewsSummary
    )
    
    summary = NewsSummary.model_validate(output.result.content)
    print(f"Title: {summary.title}")
    print(f"Summary: {summary.summary}")
    
if __name__ == "__main__":
    asyncio.run(main())

通过 CLI 运行 Index

Index CLI 特性：

• 会话间的浏览器状态持久化
• 支持“人工介入”的后续指令
• 实时流式更新
• 基于 Textual 的精美终端 UI

您可以使用以下命令运行 Index CLI：

index run

输出效果如下：

Loaded existing browser state
╭───────────────────── Interactive Mode ─────────────────────╮
│ Index Browser Agent Interactive Mode                       │
│ Type your message and press Enter. The agent will respond. │
│ Press Ctrl+C to exit.                                      │
╰────────────────────────────────────────────────────────────╯

Choose an LLM model:
1. Gemini 2.5 Flash
2. Claude 3.7 Sonnet
3. OpenAI o4-mini
Select model [1/2] (1): 3
Using OpenAI model: o4-mini
Loaded existing browser state

Your message: go to lmnr.ai, summarize pricing page

Agent is working...
Step 1: Opening lmnr.ai
Step 2: Opening Pricing page
Step 3: Scrolling for more pricing details
Step 4: Scrolling back up to view pricing tiers
Step 5: Provided concise summary of the three pricing tiers

使用个人 Chrome 实例运行 CLI

您可以使用个人的 Chrome 浏览器实例运行 Index，而无需启动全新的浏览器。这样做最大的好处是可以使用您所有已登录的会话。

# 使用默认 Chrome 路径的基本用法
index run --local-chrome

通过 API 使用 Index

在生产环境中使用 Index 最简单的方法是使用 Serverless API。Index API 负责管理远程浏览器会话、Agent 基础设施以及浏览器可观测性。若要开始使用，请在 Laminar 中创建一个项目 API Key。

安装 Laminar

pip install lmnr

通过 API 使用 Index

from lmnr import Laminar, LaminarClient
# 您也可以设置 LMNR_PROJECT_API_KEY