综合介绍

AIPy 是由网络安全公司知道创宇开发的一个开源项目。 它提供了一个特殊的方法，让大语言模型（LLM）可以直接使用电脑上的Python环境。这个方法被称为“Python-use”。 它的核心想法是，与其为AI限定一些固定的工具，不如直接把整个Python的计算能力交给AI。这样一来，AI就像一个程序员坐在电脑前，可以通过编写和运行Python代码来解决各种复杂问题。 用户可以用自然的语言下达指令，AIPy会把这些话翻译成Python代码并自动执行，来完成数据分析、文件操作、网络访问甚至控制本地应用等任务。 该项目的设计理念是“代码即智能体”（Code is Agent），旨在充分释放大模型的潜力。

功能列表

• 自然语言驱动：用户可以直接用中文或英文等自然语言下达任务指令，AIPy会调用大模型将其转换成可执行的Python代码。
• 两种运行模式：
  • 任务模式 (Task Mode)：用户只需输入任务描述，AIPy会自动完成所有步骤，适合不熟悉编程的用户。
  • Python模式 (Python Mode)：这是一个交互式的命令行环境，用户既可以输入标准的Python代码，也可以随时使用ai("任务描述")的方式让AI介入执行复杂操作，适合高级用户。
• 完整的Python生态支持：AI可以直接利用Python环境中已安装的所有库（如Pandas、Requests等）。如果任务需要的库不存在，它还会主动提示用户是否需要安装。
• 环境交互：能够读取本地文件、访问网络资源、操作电脑上的应用程序，实现与真实工作环境的结合。
• 支持多种大模型：用户可以在配置文件中指定使用不同公司的大语言模型，例如DeepSeek或腾讯混元等。
• 跨平台运行：支持Windows、macOS和Linux系统，并为Windows和macOS提供了“一键安装包”，降低了使用门槛。
• 交互过程可视化：可以将AI与用户的完整交互和执行过程保存为SVG或HTML文件，方便回顾和分享。

使用帮助

AIPy旨在成为一个强大的“智能助手”，通过结合大语言模型和Python，让用户能用自然语言完成复杂的电脑操作。下面是详细的安装和使用流程。

1. 安装AIPy

你有多种方式安装AIPy，可以根据你的操作系统和技术背景选择最合适的一种。

• 对于普通用户（推荐）为简化安装过程，AIPy为macOS和Windows用户提供了自带运行环境的“懒人安装包”。
  • Windows用户：前往官网（https://www.aipyaipy.com/）下载Windows一键安装包。下载后解压，直接运行即可，无需额外安装Python。
  • macOS用户：前往官网下载对应芯片（Intel或Apple Silicon）的macOS一键安装包。
• 对于有Python环境的开发者如果你的电脑已经安装了Python（版本要求 >= 3.9），可以直接使用pip命令进行安装。打开你的终端（在Windows上是命令提示符或PowerShell，在macOS或Linux上是终端），然后输入以下命令：

  pip install aipyapp
  

  如果你想更新到最新版本，可以使用 -U 参数：

  pip install aipyapp -U
  

2. 配置大模型

AIPy需要连接一个大语言模型（LLM）来理解你的自然语言指令。你需要一个LLM的API Key才能使用它。

1. 获取API Key：你需要从一个LLM提供商那里获取API Key。例如，你可以去DeepSeek或腾讯混元等模型的官方网站注册并获取。
2. 创建配置文件：AIPy的配置文件名为aipy.toml。
   • 在Windows上，这个文件通常在 C:\Users\你的用户名\.aipyapp\ 目录下。
   • 在macOS或Linux上，它在 ~/.aipyapp/ 目录下。
3. 编辑配置文件：使用记事本或任何文本编辑器打开aipy.toml文件，并按照下面的格式填入你的API Key。以DeepSeek为例：

   [llm.deepseek]
   type = "deepseek"
   api_key = "这里替换成你的DeepSeek API Key"
   enable = true
   default = true
   

   如果你想使用其他模型，比如腾讯混元，可以这样配置：

   [llm.hunyuan]
   type = "hunyuan"
   api_key = "你的腾讯混元API Key"
   # 如果要将其设为默认模型，请将下面这行改为true
   default = false
   

   确保default = true设置给了你希望默认使用的那个模型。

3. 如何使用AIPy

AIPy主要有两种工作模式。

• 任务模式（Task Mode）这是最简单直接的模式，非常适合用来完成一个独立、明确的任务。你只需要告诉AIPy你要做什么，它就会一步步思考、编码并执行，直到任务完成。

  如何启动：打开终端，直接输入aipy命令。

  aipy
  

  你会看到一个提示符 >>，现在你可以用自然语言输入你的任务了。

  示例：假设你想知道 /r/LocalLLaMA 这个Reddit版块上最新的帖子是什么。

  >> 获取Reddit r/LocalLLaMA的最新帖子
  

  AIPy会开始分析这个任务，可能会先尝试访问Reddit，然后解析网页内容，最后把帖子的标题显示出来。执行完毕后，它会显示 /done 并退出。

• Python模式（Python Mode）这个模式更强大和灵活，它提供了一个增强版的Python交互环境。你不仅可以运行自己的Python代码，还能在任何需要的时候呼叫AI来帮你完成更复杂的操作。

  如何启动：在终端输入以下命令，增加 --python 参数：

  aipy --python
  

  你会看到一个类似Python自带的 >>> 提示符。

  使用方法：

  1. 运行普通Python代码：你可以像在普通Python环境里一样，输入代码并立即看到结果。

     >>> x = 10
     >>> y = 20
     >>> print(x + y)
     30
     

  2. 呼叫AI：当你遇到一个复杂的任务，不想自己写代码时，可以使用ai()函数，并把你的需求写在括号里。

     >>> ai("获取谷歌首页的标题")
     

     AIPy会调用大模型生成代码（比如使用requests和BeautifulSoup库）来抓取并解析谷歌首页，然后返回标题。

  3. 自动安装依赖库：如果AI生成的代码需要一个你的电脑上没有安装的库（例如psutil），AIPy会检测到这一点，并会询问你是否同意安装。

     >>> ai("使用psutil列出MacOS上的所有进程")
     📦 LLM请求安装第三方软件包：['psutil']
     如果您同意并且已经安装，请输入'y' [y/n] (n):
     

     你只需输入 y 并回车，AIPy就会帮你处理安装。

应用场景

1. 数据分析与报告你可以让AIPy帮你处理本地的Excel或CSV文件，进行数据清洗、计算、汇总，并根据结果生成图表或格式化的HTML报告。例如，你可以直接命令：“分析这份销售数据，按季度生成销售额柱状图，并保存为report.html”。
2. 自动化日常办公用于自动处理重复性的办公任务，比如批量处理文件、从网站上抓取特定信息并整理到文档中，甚至可以编写脚本自动发送邮件。
3. 编程辅助与原型开发当你需要快速实现一个小功能或一个完整的程序（如贪吃蛇游戏）时，可以直接向AIPy描述你的想法。它能自动生成完整的代码，极大地加快了软件原型的开发速度。
4. 学习与探索对于编程初学者或希望了解某个新库用法的开发者，AIPy是一个很好的学习工具。你可以通过自然语言让它演示如何使用某个库来完成特定任务，并直接查看它生成的代码。

QA

1. AIPy是一个新的大语言模型吗？不是。AIPy本身不是一个大语言模型，而是一个连接“大语言模型”和“Python编程环境”的工具或框架。它依赖于外部的LLM（如DeepSeek）来理解指令，然后利用Python执行这些指令。
2. 它和常见的AI聊天机器人有什么区别？主要的区别在于“执行能力”。AI聊天机器人通常只能提供文本信息或代码建议，而AIPy能实际执行它生成的代码，从而直接操作你的文件、访问网络或与你的应用程序交互。它强调“知行合一”，不仅能“说”，还能“做”。
3. 使用AIPy是否安全？数据会上传吗？AIPy本身是开源的，可以部署在本地运行。 当你下达指令时，指令文本会发送给你在aipy.toml中配置的大模型提供商。AI生成的代码是在你的本地计算机上执行的。因此，你的本地文件和数据默认不会被上传，但任务描述会被发送到云端的大模型进行处理。
4. AIPy与其他AI智能体（Agent）工具有什么不同？AIPy的核心理念是“代码即智能体”，它不预设AI能使用的工具范围。而许多AI Agent工具会定义一套固定的工具（API），AI只能在这些工具中选择使用。AIPy则相信，只要给予AI完整的Python环境，它就能通过代码组合出无限的工具来解决问题，这提供了更高的灵活性和潜力。
5. 使用AIPy需要付费吗？AIPy项目本身是开源免费的。但它依赖的大语言模型服务通常是收费的，你需要支付API调用费用给相应的模型提供商（如DeepSeek、OpenAI等）。