Magick是一款突破性的可视化AIDE（人工智能开发环境），专为无代码数据管道和多模态智能体而设计。Magick能够连接到其他服务，并提供适合智能体、聊天机器人、复杂推理系统和拟人化角色的节点与模板。

🗝 核心功能

• 实时智能体：可自主执行动作，在统一的记忆和自我体系下，以多种模态与用户及其他智能体交互。
• 社交平台连接器：支持Discord、Twitter和Twilio——Zoom、Google Meet、Reddit、Slack等连接器即将作为插件推出！
• 支持谷歌、维基百科及语义网搜索。
• 内置多种实用工具，包括语音与图像生成、向量检索等。
• 强大的基于图的IDE，适用于复杂的数据管道。
• 图表可嵌套子图并共享，助力社区快速开发。

🔮 Magick：用AI自动化、构建并实现你的创意。

借助Magick，你无需掌握命令行编程即可释放AI的强大潜力。通过我们的可视化节点式环境，你可以轻松连接热门服务，探索丰富的预构建节点与连接器，将你的愿景变为现实。

▶️ 点击上方图片观看视频

核心概念

法术

法术是一种数据流动的管道，描述数据从一处流向另一处，经过我们称为“节点”的不同处理过程，并通过我们称为“连接”的线路传输。在Magick中，每个图表的数据、节点、变量和预设的集合被称为“法术”。需要注意的是，“法术”并非机器学习领域的术语，我们只是觉得这个名字很有趣。法术可以随时导入导出，其原始格式为JSON，这是一种易于分享的标准格式。

节点

从根本上说，Magick是一个用于接收数据、对其进行处理并最终输出结果的系统。

这种“处理”被称为“转换”，数据会从一种形式转变为另一种形式。而执行转换的“黑盒”则是一个输入任意类型数据、输出任意类型数据的模块。我们称这个进行转换的黑盒为“节点”。节点是Magick的基础构建块。

创建节点

节点可以在“法术”选项卡的编辑窗口中创建。你可以在编辑窗口中右键单击，从上下文菜单中添加节点；也可以直接将“节点”选项卡中的节点拖放到编辑窗口中。此外，还可以通过拖拽来重新排列节点的位置。

要删除节点，只需右键单击该节点并选择“删除”。

节点类型

• 输入节点
• 提示模板
• 代码节点：允许你自定义输入和输出。
• 生成器节点：允许你定义自己的输入端口，并在节点内部处理这些数据。
• 等待所有节点：用于等待多个执行分支完成后再合并为一个分支——这是同时执行多项耗时任务的好方法。
• …还有更多！（如果你有任何建议，请告诉我们）

输入与输出

所有节点都具有输入和/或输出，但不一定同时具备两者。输入和输出以插座的形式直观地显示出来。插座的颜色决定了它可以接收的数据类型，“灰色”表示默认的未指定类型或“任意”类型。

插座

传入插座的数据对节点可用。节点可以对这些数据进行处理，并将结果返回到输出插座。有些节点（如生成器节点）允许你自定义输入端口，然后在节点内部处理这些数据。而另一些节点（如代码节点）则允许你同时定义输入和输出。

触发器

触发器用于启动节点的异步任务。部分节点无需触发器即可处理数据，但大多数节点需要触发器。触发器可以从一个插座发送到多个输入端口，不过执行顺序无法保证。此时可以使用“等待所有”节点来等待各个执行分支完成后再合并为一个分支——这正是同时执行多项耗时任务的理想方式。

---

⚙️ 安装

请根据你的操作系统选择相应的安装指南，获取详细的设置说明：

• macOS安装指南
• Linux安装指南
• Windows安装指南

每个指南包含以下内容：

• 系统要求与先决条件
• 分步安装说明
• 环境搭建
• 数据库配置
• 故障排除提示

如需更详细的开发文档和架构概述，请参阅：

• 开发指南
• 架构概述

开发提示

自签名证书

在本地开发时，你可能希望Chrome接受来自localhost的自签名证书。为此，请按照以下步骤操作：

1. 打开：chrome://flags/#allow-insecure-localhost
2. 启用该功能

贡献者

Michael 💻 📦 💼	M̵̞̗̝̼̅̏̎͝Ȯ̴̝̻̊̃̋̀Õ̷̼͋N̸̩̿͜ ̶̜̠̹̼̩͒ 💻 📦	alextitonis 💻	Daniel Adams 💻	Anthony Burchell 💻 📝	jin 📝	Shivaditya Shivganesh 💻
khalildh 💻	Pigloo 💻	avirtualfuture 💻 📖	Alexandre Ferreira 💻	Matei Anghel 💻	Trentalantar 📖	Lisa Mega Watts 📖
r2 📖	IRANKUNDA Fabrice 💻	Kien Nguyen 💻	Ben Moore 💻	Q 💻	thomageanderson 💻	Pietro 💻
codingsh 💻	Ben Botwin 💻 📦	K. S. Ernest (iFire) Lee 💻	coffeeorgreentea 💻 🚇 💼	Knar 💻	Emmy NSABIMANA 💻

基于 Latitude Games 的 Thoth

原始源代码由以下 Thoth 贡献者编写，该项目已归档在 这里。

Jakob 💻

Sean Gillespie 💻

Michael 💻

Preston Gull 💻🎨

Nick Walton 💻

Mitchell Gordon 💻

?/janus 💻

Alan Walton 💻

来和我们一起构建吧！

我们正在 Discord 上以开放社区的形式共同构建 Magick。如果你对参与这个项目感兴趣，我们非常欢迎你的加入。

立即加入：https://bit.ly/magickdiscordgh

Magick 快速上手指南

Magick 是一款突破性的可视化 AI 开发环境（AIDE），专为无代码数据管道和多模态智能体设计。通过基于节点的图形界面，您可以轻松构建智能代理、聊天机器人、复杂推理系统及虚拟角色，无需编写复杂的命令行代码。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

系统要求

• 操作系统：macOS, Linux, 或 Windows
• 内存：建议 8GB 及以上
• 磁盘空间：至少 5GB 可用空间

前置依赖

• Node.js：推荐最新 LTS 版本
• Git：用于克隆仓库
• 数据库：根据官方文档需配置本地数据库（通常为 PostgreSQL 或 SQLite，具体视安装脚本而定）
• 浏览器：推荐使用 Chrome（开发模式下需支持自签名证书）

注意：国内用户若遇到网络问题，建议在克隆仓库或安装依赖时使用国内镜像源（如淘宝 npm 镜像）。

安装步骤

请选择对应您操作系统的安装方式：

1. 获取源码

git clone https://github.com/Oneirocom/Magick.git
cd Magick

(国内加速): 如果 GitHub 连接缓慢，可使用镜像：

git clone https://gitee.com/mirror/Oneirocom-Magick.git # 示例镜像地址，请以实际可用源为准
cd Magick

2. 安装依赖

npm install
# 或者使用国内镜像加速
npm install --registry=https://registry.npmmirror.com

3. 环境配置与数据库初始化

根据项目根目录下的 .env.example 创建配置文件：

cp .env.example .env

编辑 .env 文件填入必要的 API Key 和数据库连接信息。

运行数据库迁移或初始化脚本（具体命令参考各系统详细文档）：

npm run db:migrate

4. 启动应用

npm run dev

启动后，通常在浏览器访问 http://localhost:3000 (端口号以实际输出为准) 即可进入可视化界面。

开发提示：若在本地开发遇到 Chrome 拦截自签名证书，请在地址栏输入 chrome://flags/#allow-insecure-localhost 并启用该选项。

基本使用

Magick 的核心工作流是通过“咒语”（Spells）来构建数据管道。以下是创建一个简单流程的步骤：

核心概念

• Spells (咒语)：即数据管道，由节点和连接线组成，本质是 JSON 格式，可导入导出。
• Nodes (节点)：处理数据的基本单元（黑盒），接收输入并进行转换后输出。
• Sockets (插槽)：节点上的输入/输出接口，颜色代表数据类型（灰色为通用类型）。

快速示例：构建一个简单的文本处理流

1. 进入创作界面： 启动应用后，点击左侧菜单栏的 "Spells" 标签页，进入作曲器（Composer）窗口。

2. 添加节点：

   • 方法一：在画布空白处右键点击，从上下文菜单中选择节点。
   • 方法二：从左侧 "Nodes" 面板拖拽节点到画布。

   示例场景：创建一个从输入到生成的简单流。

   • 拖入一个 Input Node (输入节点)。
   • 拖入一个 Prompt Template (提示词模板节点)。
   • 拖入一个 Generator Node (生成节点，用于调用 AI 模型)。

3. 连接节点： 鼠标从一个节点的输出插槽（Output Socket）拖拽连线到下一个节点的输入插槽（Input Socket）。

   • 将 Input Node 的输出连接到 Prompt Template 的输入。
   • 将 Prompt Template 的输出连接到 Generator Node 的输入。

4. 配置与运行：

   • 点击 Input Node，在属性面板设置初始文本数据。
   • 点击 Prompt Template，编辑提示词逻辑（例如："请总结以下内容：{{input}}"）。
   • 点击 Generator Node，选择所需的 AI 模型并配置参数。

   大部分节点需要 Trigger (触发器) 来启动异步任务。确保触发信号能正确传递。

5. 执行流程： 点击画布上的运行按钮（或通过触发器启动），观察数据流经各个节点，最终在输出节点查看结果。

高级技巧

• 并行处理：使用 Wait For All Node 等待多个并行分支（如同时搜索 Google 和 Wikipedia）完成后，再合并数据流。
• 自定义逻辑：使用 Code Node 编写自定义 JavaScript 代码来处理特定的输入输出逻辑。
• 复用与分享：完成的 Spell 可导出为 JSON 文件，方便在社区分享或作为子图（Subgraph）嵌入到其他项目中。