perplexity-ai

环境要求

• Python 环境（README 使用 uv 管理依赖）
• 已安装 uv 包管理器
• 使用自带账号时需准备 Perplexity 的 Cookies
• 账号生成功能需准备 Emailnator 的 Cookies
• Web 界面需额外安装 driver 扩展与 Chromium（patchright）

安装与启动步骤

1. 1基础安装依赖

   克隆项目后在根目录执行基础安装，会同步项目运行所需依赖。注意需先装好 uv。

   uv sync

   复制

2. 2安装 MCP 扩展

   若需要 MCP Server 能力，加上 mcp 可选依赖一起同步。

   uv sync --extra mcp

   复制

3. 3全局安装 CLI 工具

   以工具形式全局安装 perplexity-mcp 命令，不需要本地虚拟环境。必须带 [mcp]。

   uv tool install '.[mcp]'

   复制

4. 4安装 Web 界面依赖

   使用图形界面时安装 driver 扩展，并安装 patchright 的 Chromium 浏览器。

   uv sync --extra driver
   uv run patchright install chromium

   复制

5. 5安装开发依赖

   开发模式安装，包含 pytest、flake8、black、isort、mypy 等测试与检查工具。

   uv sync --extra dev

   复制

6. 6运行测试验证

   跑一遍测试确认安装成功，全部通过即代表环境可用。

   uv run pytest tests/ -v

   复制

7. 7编写调用代码

   导入 perplexity 并调用 search 提问，需要传自己的 cookies 时先准备好 Cookie 字典。

   import perplexity
   
   perplexity_cli = perplexity.Client()
   resp = perplexity_cli.search('Your query here', mode='reasoning', sources=['web'], stream=False, language='en-US')
   print(resp)

   复制

8. 8异步调用示例

   需要异步时可使用 perplexity_async，用 asyncio.run 启动协程。

   import asyncio
   import perplexity_async
   
   async def main():
       client = await perplexity_async.Client()
       response = await client.search("What is machine learning?")
       print(response['answer'])
   
   asyncio.run(main())

   复制

关键配置

如何确认成功

执行 uv run pytest tests/ -v 全部通过；或调用 search 能返回结果并打印出 answer 字段。

常见问题

注意事项

• 这是非官方封装工具，README 明确为 unofficial，使用时注意服务条款与账号风险。
• 所有 Cookie 均为敏感凭证，请勿提交到公开仓库或分享给他人。
• perplexity-mcp 作为全局工具安装时必须带 [mcp] 扩展，否则命令不可用。
• MCP Server 传输方式由 MCP_TRANSPORT 环境变量控制，默认 stdio。