AiPy

AiPy是什么

AiPy是一款由知道创宇团队开发的本地AI执行工具，项目名称也写作AIPyApp或Python-Use。它把大语言模型与Python解释器结合，让AI围绕任务自动规划、生成代码、执行、读取结果并继续修正。

它强调交付任务结果，而不是只生成一段代码供用户复制。由于程序能够访问本机文件、网络、数据库和系统资源，能力比普通聊天工具更强，安全风险也更高。

核心工作循环

• 接收自然语言任务。
• 把目标拆分为执行步骤。
• 生成合适的Python代码。
• 在本地环境执行代码。
• 读取输出、错误和环境反馈。
• 自动调整方案并再次执行。
• 整理文件、分析结果或最终报告。

主要功能

• 自然语言驱动Python执行。
• 本地文件读取与批量处理。
• 表格清洗、统计和可视化。
• 网页访问与数据整理。
• 调用第三方API。
• 按需使用Python软件包。
• 连接数据库和局域网资源。
• 生成程序、文档和媒体文件。
• 自动调试执行错误。
• 桌面界面与命令行两种使用路径。

Task任务模式

Task Mode是默认模式，用户直接描述希望完成的工作，不必先写Python代码。AiPy会把代码作为内部执行手段，最终返回结果或生成的文件。

• 适合不熟悉Python的用户。
• 以任务目标而不是代码片段为中心。
• 允许模型连续规划和修错。
• 适合数据整理与办公自动化。
• 高风险操作仍需人工确认。

Python模式

Python Mode面向熟悉Python的进阶用户，既能输入普通Python命令，也能通过AI函数下达任务。用户可以更直接地检查变量、执行过程和模型生成的代码。

本地文件处理

• 读取CSV、Excel和文本文件。
• 批量重命名或整理目录。
• 提取PDF和文档中的信息。
• 合并、拆分和转换数据。
• 生成统计结果与图表。
• 把处理结果写入新文件。

数据分析

AiPy可借助Pandas、OpenPyXL、Seaborn等Python生态处理本地数据。相比把整个文件上传到云端对话，它更适合需要在本机计算的大型数据，但模型仍可能写出错误分析逻辑。

• 检查字段类型和缺失值。
• 清洗重复或异常记录。
• 分组统计和透视分析。
• 生成趋势与分布图。
• 导出新的表格或报告。
• 对结论进行抽样复核。

网页与API自动化

模型可以生成Python代码访问网页或调用公开API，并把结果转换为结构化数据。使用时需要遵守网站条款、访问频率、登录权限和个人信息保护要求。

第三方软件包

当任务需要当前环境中不存在的库时，AiPy可以提出安装请求，示例流程会先让用户确认。不要同意安装来源不明或名称相似的包，企业环境应使用允许清单和固定版本。

本地设备与局域网

官网案例展示了连接手机、查找局域网打印机和调用本地软件等任务。能否成功取决于操作系统、驱动、网络权限、设备协议和具体程序接口，并非所有设备都能直接控制。

程序与原型生成

AiPy可以根据需求生成代码、运行测试、修复错误并把项目保存到电脑。官网展示过小游戏和网页原型案例，但所谓可运行结果仍需人工做安全、功能和许可证检查。

文档与合同分析

工具可以读取文档并辅助查找条款、归纳信息或生成修改建议。法律、招投标和合同结论不能仅依赖模型，最终版本应由具备相应责任和专业资质的人员审核。

音视频处理

借助Python库和本地模型，AiPy能够编排音频提取、语音识别、字幕整理和媒体转换任务。处理速度、准确率与可用格式由具体软件包和硬件决定。

支持的平台

模型配置

开源版通过配置文件连接大模型，官方示例使用DeepSeek类型和对应API Key。项目同时依赖OpenAI与Anthropic兼容库，但具体模型可用性应以当前代码、配置文档和服务商接口为准。

• 从模型服务商创建API Key。
• 只把密钥写入受保护的本地配置。
• 不要把配置文件提交到代码仓库。
• 设置模型类型和必要的接口参数。
• 用低风险任务测试连接。
• 监控令牌消耗和账户账单。
• 定期轮换已暴露或长期使用的密钥。

桌面版安装教程

1. 根据电脑系统和芯片选择对应安装包。
2. 从项目官方入口下载并检查文件。
3. 安装到普通用户可控的目录。
4. 首次启动时只授予完成任务所需权限。
5. 配置自己的模型服务和API Key。
6. 用一个不含敏感数据的测试任务验证。
7. 确认执行过程可见且输出符合预期。

命令行安装教程

1. 安装Python 3.11或更高版本。
2. 创建独立虚拟环境隔离依赖。
3. 通过Python包管理器安装aipyapp。
4. 在用户配置目录创建模型配置文件。
5. 写入模型类型和自己的API Key。
6. 启动aipy进入默认任务模式。
7. 先在测试目录中执行低权限任务。

数据分析教程

1. 复制一份原始数据作为只读备份。
2. 在隔离目录放入待分析文件。
3. 描述字段、目标和期望输出格式。
4. 要求AiPy先检查数据而不要直接覆盖。
5. 查看生成的统计逻辑和异常提示。
6. 抽样核对关键记录与计算结果。
7. 确认无误后导出新文件和图表。

安全执行教程

1. 为AiPy建立专用系统账户或隔离环境。
2. 只挂载任务需要的文件副本。
3. 移除生产密钥、浏览器会话和私人资料。
4. 限制网络、数据库和系统命令权限。
5. 逐步审查模型计划和拟执行代码。
6. 拒绝来源不明的软件包安装请求。
7. 完成后检查文件变化、进程和访问日志。

适合哪些用户

• 希望用自然语言处理本地数据的用户。
• 熟悉风险控制的Python开发者。
• 需要快速制作自动化原型的团队。
• 需要批量处理办公文件的分析人员。
• 研究代码执行型智能体的开发者。
• 希望审查和二次修改源代码的组织。

典型使用场景

• 清洗和分析大型表格。
• 批量整理本地文件。
• 生成数据图表和报告。
• 调用业务API汇总信息。
• 制作网页或小程序原型。
• 从视频提取语音并生成字幕。
• 连接数据库完成一次性分析。
• 编排局域网设备操作实验。

不太适合哪些情况

• 无法隔离敏感生产数据的环境。
• 不允许自动执行生成代码的企业。
• 需要模型对法律或财务结论负责。
• 希望完全免配置使用云端智能体的用户。
• 不能审查模型行为和系统权限的团队。
• 计划未经授权把项目封装成商业SaaS。
• 要求厂商提供完整商业SLA的关键系统。

免费与使用成本

AiPy桌面版和开源代码可免费获取，官网没有公开个人订阅套餐。实际使用成本主要来自模型API、计算资源、第三方服务、硬件和企业运维。

开源许可证

仓库许可证声明以GPL 3.0为基础，同时加入两项商业限制。未经许可，不得把项目作为SaaS向第三方提供，也不得把项目或代码集成到商业产品中销售或赠送。

许可证兼容性提醒

带有额外限制的许可证不应被简单宣传为标准GPL 3.0，也不能仅凭开源仓库就推断任何商业方式都可用。计划分发、托管或集成前，应由法律人员核对项目许可证与所有依赖。

代码执行安全风险

项目免责声明明确提醒，模型生成的代码可能删除文件、访问网络、执行系统命令或造成数据与隐私损害。AiPy不能保证代码准确、完整或适合具体用途，使用者需要自行承担执行后果。

• 错误代码可能覆盖或删除文件。
• 网络请求可能上传敏感信息。
• 系统命令可能改变电脑配置。
• 恶意网页内容可能诱导模型执行操作。
• 第三方软件包可能带来供应链风险。
• 数据库写入可能破坏生产数据。
• 错误分析可能形成误导性结论。

安全使用建议

• 优先在虚拟机或容器中运行。
• 使用普通账户而不是管理员权限。
• 处理文件副本而不是唯一原件。
• 默认禁止访问生产数据库。
• 为API Key设置最小权限和额度。
• 对写入、删除和外发操作人工确认。
• 记录生成代码和执行日志。
• 定期更新依赖并检查安全公告。

数据隐私

AiPy在本地执行Python不代表任务数据一定不离开电脑，提示词和上下文可能发送给配置的大模型服务商。使用前应确认发送内容、模型供应商的数据政策、日志保留和企业合规要求。

与普通AI编程助手的区别

产品优势

• 把规划、写代码和执行连成闭环。
• 可直接处理本地文件与数据。
• 利用丰富的Python软件生态。
• 同时提供任务模式和Python模式。
• 支持Windows、macOS和Linux路径。
• 源代码公开便于审查和修改。
• 中文用户可较容易上手。
• 适合快速验证自动化任务。

使用限制

• 自动生成代码可能包含危险操作。
• 结果准确性依赖模型和任务描述。
• 使用云端模型仍会产生API成本。
• 本地执行不等于数据完全不外发。
• 第三方包安装存在供应链风险。
• 复杂设备控制依赖驱动和系统权限。
• 商业SaaS和产品集成受附加限制。
• 高风险业务必须人工复核。

基本信息

推荐指数

综合推荐指数为4.0分，满分5分。AiPy对本地数据处理和任务自动化很有探索价值，但更适合能建立隔离环境、检查代码和控制权限的用户。

常见问题

AiPy免费吗？

软件可免费下载，模型API、第三方接口、本地硬件和商业授权可能产生费用。

AiPy会执行代码吗？

会，它的核心就是让模型生成并在Python环境中执行代码，再根据反馈继续调整。

不会Python可以使用吗？

可以使用默认任务模式，但仍需要理解权限、文件备份和自动执行风险。

支持哪些系统？

官网提供Windows、macOS Apple芯片、macOS Intel芯片和Linux下载路径。

需要自己的模型API Key吗？

开源命令行配置示例要求填写模型服务商的API Key，桌面版具体配置以当前版本为准。

本地运行是否代表完全离线？

不代表，连接云端大模型或外部API时，任务上下文可能发送到第三方。

AiPy使用什么许可证？

许可证以GPL 3.0为基础，但额外限制未经授权的SaaS和商业产品集成。

可以把AiPy做成付费SaaS吗？

未经许可不可以，许可证明确要求此类用途先取得商业授权。

适合在生产电脑直接运行吗？

不建议无隔离直接运行，应使用低权限环境、文件副本和严格的人工确认。