agentica

环境要求

• 已安装 Node.js 与 npm（安装向导通过 npx 运行）
• 可联网访问 npm 仓库
• 命令行终端（支持交互式选择，方向键操作）
• 项目目录可写权限

安装与启动步骤

1. 1准备 Node.js 环境

   该框架基于 TypeScript，安装向导通过 npx 执行，需先确保本机已装好 Node.js 与 npm。

2. 2运行安装向导

   执行脚手架命令创建新项目，把 换成你自己的目录名，例如 my-agent。

   npx agentica start my-agent

   复制

3. 3选择包管理器

   用方向键选择 npm、pnpm 或 yarn；注意 yarn berry 不受支持，选择后回车确认。

4. 4选择项目类型

   可选 NodeJS Agent Server、NestJS Agent Server、React Client Application 或 Standalone Application。

5. 5选择内置控制器

   可多选，包括 Google Calendar、Google News、Github、Reddit、Slack 等，也可选 (none) 不启用。

6. 6查阅官方文档

   向导完成后如需更完整的配置与开发说明，访问官方 Getting Started 文档继续。

如何确认成功

向导执行完毕后在指定目录生成新项目结构，即为创建成功；README 未给出其他启动验证方式。

常见问题

注意事项

• README 只提供了 npx agentica start 这一个安装命令，其余步骤均来自向导的交互选项。
• 向导为交互式流程，运行后需用方向键与回车逐步选择，不要中途中断。
• 除 Standalone Application 外的项目类型会自动实现 WebSocket 协议。
• 更详细的部署与使用说明请以官网文档 https://wrtnlabs.io/agentica/docs/ 为准。