1. 项目定位与用途
PenguinHarness 是开源本地优先的多智能体应用开发平台，基于 TypeScript 开发，采用 pnpm monorepo 架构，核心 SDK 提供智能体创建、会话运行、消息处理、上下文管理等基础能力，配套 CLI、服务端、Web 控制台、桌面端、文档站点、落地页等独立子模块，覆盖 AI 应用构建、优化、部署全生命周期，采用 Apache 2.0 协议开源，支持 1000+ 大模型接入。
项目档案应用项目
PenguinHarness 开源多智能体应用开发平台 - 自然语言生成AI智能体 本地部署教程
PenguinHarness 是开源本地优先的多智能体应用开发平台，支持自然语言一句话生成可运行的AI智能体应用，覆盖构建、优化、部署全生命周期，本文介绍项目定位、安装方式、使用指南及核心特性。
AI 总结
PenguinHarness 是开源本地优先的多智能体应用开发平台，支持自然语言一句话生成可运行的AI智能体应用，覆盖构建、优化、部署全生命周期，主打低成本、高透明度的多智能体自动开发能力。
中文项目介绍
PenguinHarness 是基于 TypeScript 构建的开源本地优先多智能体应用开发平台，采用 pnpm monorepo 架构，核心 SDK 提供智能体创建、会话运行、消息处理、上下文管理等基础能力，配套 CLI 工具、Web 控制台、桌面端、文档站点等独立子模块，采用 Apache 2.0 协议开源，覆盖 AI 应用构建、优化、部署全生命周期。
传统智能体开发需手动编写代码、开发效率低、成本高，且多智能体协同开发缺乏透明化机制。PenguinHarness 通过极简工具集配合底层干净接口，减少工具调用与 Token 消耗，深度适配 DeepSeek 等开源模型，实现自然语言驱动的全自动智能体应用生成，解决 AI 应用开发门槛高、推理成本高、流程不透明的问题。
平台支持对接 1000+ 大模型，可本地对接 Ollama 开源模型运行，无需云端 API 即可执行核心智能体能力，具备智能体自我进化、用智能体构建智能体等核心能力，适用于快速生成 RAG 等智能体应用、多智能体协同开发优化 AI 应用、本地化部署私有 AI 应用开发平台等场景。
详细信息与使用说明
2. 解决的问题
传统智能体开发需手动编写代码、开发效率低、成本高，且多智能体协同开发缺乏透明化机制。PenguinHarness 通过极简工具集配合底层干净接口，减少工具调用与 Token 消耗，深度适配 DeepSeek 等开源模型，实现自然语言驱动的全自动智能体应用生成，解决 AI 应用开发门槛高、推理成本高、流程不透明的问题，数据分析和编码场景的成本仅为同类方案的几十分之一。
3. 适用场景
适用于需要快速生成 RAG 等智能体应用的场景，支持多智能体协同自动开发、优化 AI 应用，可本地化部署私有 AI 应用开发平台，也支持智能体自我迭代与性能优化。平台支持对接 1000+ 大模型，也可本地对接 Ollama 开源模型运行，无需云端 API 即可执行核心智能体能力，满足不同用户的开发与部署需求。
4. 安装方式
环境要求 Node.js >=24、包管理器 [email protected]。安装步骤为：复制 .env.example 为 .env 并配置对应大模型 API 密钥（如 ANTHROPIC_API_KEY、DEEPSEEK_API_KEY 及可选网关地址），执行 pnpm install 安装所有依赖，执行 pnpm build 完成全子包构建与 CLI 全局链接，完成后即可全局调用 penguin 命令。仓库中未明确给出其他安装方式。
5. 使用方式
CLI 全局链接完成后可直接执行 penguin 命令启动平台；开发模式下执行 pnpm dev 可同时启动服务端与 Web 控制台；通过自然语言描述需求即可自动生成完整智能体应用，如描述 RAG 需求即可自动生成可运行应用；可参考 examples 目录下的自进化智能体、用智能体构建智能体等示例脚本运行验证。仓库中未明确给出可视化界面的具体操作步骤。
6. 补充说明与实现特点
项目采用本地优先运行模式，支持会话恢复、上下文压缩、Trace 全流程追溯等能力，保障多轮任务的可观测性与稳定性；内置自进化智能体示例，支持智能体通过评估-诊断-编辑-重评估循环实现自我改进；支持用智能体构建智能体的能力，可通过 SDK 分步实现新智能体的构建与验证。仓库中未明确给出所有子模块的详细实现原理。
思维导图
PenguinHarness
核心架构
pnpm Monorepo
TypeScript 开发
Apache 2.0 开源
核心能力
自然语言生成智能体
多智能体协同开发
智能体自我进化
1000+ 模型支持
本地优先运行
子模块
@penguin-core 核心SDK
@penguin-cli 命令行工具
@penguin-server 服务端
@penguin-web Web控制台
@penguin-desktop 桌面端
@penguin-docs 文档站点
@penguin-landing 落地页
开发与运行
示例生态
自进化智能体示例
用智能体构建智能体示例
常见问题
PenguinHarness 是什么？
PenguinHarness 是开源本地优先的多智能体应用开发平台，基于 TypeScript 开发，支持自然语言驱动自动生成 AI 智能体应用，覆盖构建、优化、部署全生命周期，采用 Apache 2.0 协议开源。
安装 PenguinHarness 需要什么环境？
需要 Node.js >=24、包管理器 [email protected]，安装前需复制 .env.example 为 .env 并配置对应大模型 API 密钥（如 ANTHROPIC_API_KEY、DEEPSEEK_API_KEY），之后执行 pnpm install 和 pnpm build 即可完成安装。
PenguinHarness 支持哪些模型？
平台支持 1000+ 大模型，也可本地对接 Ollama 开源模型运行，无需云端 API 即可执行核心智能体能力，默认优先适配 DeepSeek 等开源模型以降低推理成本。
如何使用 PenguinHarness 生成智能体应用？
安装完成后可通过 penguin 命令启动平台，或用自然语言描述需求即可自动生成完整智能体应用，也可参考 examples 目录下的自进化智能体、用智能体构建智能体等示例脚本运行验证。
PenguinHarness 的核心优势是什么？
相比传统手动开发智能体的方式，PenguinHarness 可实现多智能体自动开发，开发效率提升数十倍，推理成本仅为同类方案的几十分之一，且全流程透明可追溯，支持智能体自我进化。