懂AI
windmill

windmill

开源内部工具开发平台 支持多语言脚本和自动UI生成

Windmill是一个开源开发者平台，用于构建内部工具。它支持多种脚本语言，包括Python、TypeScript、Go等，可自动生成UI界面，并允许将脚本组合成工作流或构建复杂应用。作为Retool等工具的替代方案，Windmill提供自托管选项，简化了API、后台任务和工作流的开发过程。

Windmill开源内部工具工作流脚本Github开源项目
访问官网GitHub文档
<p align="center"> <a href="https://www.windmill.dev/"><img src="https://yellow-cdn.veclightyear.com/835a84d5/8ff58413-9d6b-4e64-9c57-b4568eac8b33.png" alt="windmill.dev"></a> </p> <p align=center> 开源的内部工具开发基础设施（API、后台任务、工作流和用户界面）。可自托管的Retool、Pipedream、Superblocks替代品，以及简化版的Temporal，具有自动生成的用户界面和自定义用户界面，用于触发工作流和脚本作为内部应用。 <p align=center> 脚本自动转换为可共享的用户界面，可以组合成流程或用于构建更丰富的低代码应用。支持的脚本语言包括：Python、TypeScript、Go、Bash、SQL和GraphQL。 </p> <p align="center"> <a href="https://github.com/windmill-labs/windmill/blob/main/LICENSE-AGPL" target="_blank"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/98fba394-5f45-4f1d-af7e-576d7fcfb963.svg" alt="Package version"> </a> <a href="https://github.com/windmill-labs/windmill/actions/workflows/docker-image.yml" target="_blank"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/c5b97941-5c4b-4a83-b2ef-7b90105e67a7.svg" alt="Docker Image CI"> </a> <a href="https://pypi.org/project/wmill" target="_blank"> <img src="https://img.shields.io/pypi/v/wmill?color=%2334D058&label=pypi%20package" alt="Package version"> </a> </p> <p align="center"> <a href="https://img.shields.io/github/commit-activity/m/windmill-labs/windmill" target="_blank"> <img src="https://img.shields.io/github/commit-activity/m/windmill-labs/windmill" alt="Commit activity"> </a> <a href="https://discord.gg/V7PM2YHsPB" target="_blank"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/166c740e-73be-4467-aaaf-02ec1dea9ee7.png" alt="Discord Shield"/> </a> </p> <p align="center"> <a href="https://app.windmill.dev">试用</a> - <a href="https://www.windmill.dev/docs/intro/">文档</a> - <a href="https://discord.gg/V7PM2YHsPB">Discord</a> - <a href="https://hub.windmill.dev">Hub</a> - <a href="https://www.windmill.dev/docs/misc/contributing">贡献者指南</a> </p>

Windmill - API、后台任务、工作流和用户界面的开发者平台

Windmill 是<b>完全开源的（AGPLv3）</b>，Windmill Labs 提供专用实例、商业支持和许可证。

Windmill Diagram

https://github.com/windmill-labs/windmill/assets/122811744/0b132cd1-ee67-4505-822f-0c7ee7104252

主要概念

  1. 用Python、TypeScript、Go或Bash定义一个最小化和通用的脚本，解决特定任务。代码可以在提供的Web IDE中定义，或者与您自己的GitHub仓库同步（例如通过VS Code扩展）：

    步骤1

  2. 您的脚本参数会自动解析并生成前端。

步骤2

步骤3

  1. 让它流动起来！您可以链接您的脚本或社区在WindmillHub上共享的脚本。

    步骤3

  2. 在您的脚本和流程之上构建复杂的用户界面。

    步骤4

脚本和流程也可以通过cron调度（例如 '*/5 * * * *'）或webhooks触发。

您可以在Windmill之上构建整个基础设施！

展示一些实际的脚本代码

//从npm导入任何依赖
import * as wmill from "windmill-client"
import * as cowsay from 'cowsay@1.5.0';

// 填写类型，或使用+Resource类型获取资源的类型安全引用
type Postgresql = {
  host: string;
  port: number;
  user: string;
  dbname: string;
  sslmode: string;
  password: string;
};

export async function main(
  a: number,
  b: "my" | "enum",
  c: Postgresql,
  d = "从默认参数推断的字符串类型",
  e = { nested: "object" }
  //f: wmill.Base64
) {
  const email = process.env["WM_EMAIL"];
  // 变量是有权限的，按路径
  let variable = await wmill.getVariable("f/company-folder/my_secret");
  const lastTimeRun = await wmill.getState();
  // 日志会被打印并始终可检查
  console.log(cowsay.say({ text: "你好 " + email + " " + lastTimeRun }));
  await wmill.setState(Date.now());

  // 返回值序列化为JSON
  return { foo: d, variable };
}

命令行界面

我们有一个强大的命令行界面（CLI）可以与Windmill平台交互，并从本地文件、GitHub仓库同步您的脚本，以及通过本地命令在实例上运行脚本和流程。查看更多详情。

CLI 屏幕录像

本地运行脚本

您可以轻松地在本地运行脚本，只需为wmill客户端库传递正确的环境变量，以便在需要时从您的实例获取资源和变量。详情请见： https://www.windmill.dev/docs/advanced/local_development。

为了在本地开发和测试脚本和流程，我们推荐使用Windmill VS Code扩展：https://www.windmill.dev/docs/cli_local_dev/vscode-extension。

技术栈

  • Postgres作为数据库。
  • 后端使用Rust，具有以下高可用性和水平可扩展的架构：
    • 无状态API后端。
    • 从Postgres队列（后续可能是Kafka或Redis）中拉取作业的工作器。 如果感兴趣，请为#173投票。
  • 前端使用Svelte。
  • 脚本执行使用Google的nsjail进行沙箱隔离。
  • JavaScript运行时使用deno_core rust库（该库本身使用rusty_v8，因此底层是V8）。
  • TypeScript运行时是Bun和deno。
  • Python运行时是python3。
  • Golang运行时是1.19.1。

最快的可自托管工作流引擎

我们将Windmill与其他可自托管的工作流引擎（Airflow、Prefect和Temporal）进行了比较，Windmill在两个基准测试中都是性能最佳的解决方案：一个由40个轻量级任务组成的流程，以及一个由10个长时间运行任务组成的流程。

所有方法论和结果可在我们的基准测试页面上查看。

最快的工作流引擎

安全性

沙箱隔离

Windmill可以使用nsjail。它具有生产级多租户安全性。不要相信我们的话，请参考fly.io的评价。

密钥、凭证和敏感值

每个工作区都有一个加密密钥，用于加密存储在Windmill的键值存储中的凭证和密钥。

此外，我们强烈建议您加密整个Postgres数据库。这正是我们在https://app.windmill.dev上所做的。

性能

一旦作业开始，与在节点上使用相应运行器（Deno/Go/Python/Bash）运行相同脚本相比，没有额外开销。从队列中拉取作业、启动作业，然后将结果发送回数据库的额外延迟约为50毫秒。一个典型的轻量级deno作业总共需要大约100毫秒。

架构

<p align="center"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/3a2dd348-916c-4b1c-99ba-c05c44787069.svg"> </p>

如何自托管

这里我们只提供docker-compose设置。对于更高级的设置，如从源代码编译或不使用postgres超级用户，请参阅自托管文档。

Docker compose

Windmill可以使用3个文件（docker-compose.yml、Caddyfile和.env）通过一个命令部署。

确保Docker已启动，然后运行：

curl https://raw.githubusercontent.com/windmill-labs/windmill/main/docker-compose.yml -o docker-compose.yml
curl https://raw.githubusercontent.com/windmill-labs/windmill/main/Caddyfile -o Caddyfile
curl https://raw.githubusercontent.com/windmill-labs/windmill/main/.env -o .env

docker compose up -d

访问http://localhost，搞定！

默认的超级管理员用户是：admin@windmill.dev / changeme。

从这里，您可以按照设置应用程序创建其他用户。

更多详情请参阅自托管文档。

Kubernetes（k8s）和Helm charts

我们在以下地址发布helm charts： https://github.com/windmill-labs/windmill-helm-charts。

从二进制文件运行

每个发布版本都包含相应的x86_64二进制文件。您可以使用以下一组bash命令简单地下载最新的windmill二进制文件。

BINARY_NAME='windmill-amd64' # 或windmill-ee-amd64（企业版）
LATEST_RELEASE=$(curl -L -s -H 'Accept: application/json' https://github.com/windmill-labs/windmill/releases/latest)
LATEST_VERSION=$(echo $LATEST_RELEASE | sed -e 's/.*"tag_name":"\([^"]*\)".*/\1/')
ARTIFACT_URL="https://github.com/windmill-labs/windmill/releases/download/$LATEST_VERSION/$BINARY_NAME"
wget "$ARTIFACT_URL" -O windmill

OAuth、SSO和SMTP

Windmill社区版允许直接从UI的超级管理员设置中配置OAuth、SSO（包括Google Workspace SSO、Microsoft/Azure和Okta）。请注意，社区版的SSO用户数量限制为10个。

查看文档。

商业许可

要自托管Windmill，您必须遵守AGPLv3许可的条款，对于个人使用您不需要担心。对于商业用途，如果您不以任何方式向用户重新暴露Windmill，并且对AGPLv3感到满意，那么您应该没问题。

要将任何Windmill部分重新暴露给您的用户作为产品功能，或在Windmill之上构建功能，为了遵守AGPLv3，您的产品必须是AGPLv3，或者您必须获得商业许可。如果您有任何疑问，请联系ruben@windmill.dev。

此外，商业许可还为您提供专门的工程师，帮助您将当前基础设施过渡到Windmill，提供严格SLA的支持，以及我们的全局缓存同步，用于10+节点到200+节点集群的高性能/无依赖缓存未命中。

集成

在Windmill中，集成被称为资源和资源类型。每个资源都有一个资源类型，定义了资源需要实现的模式。

在自托管实例上，您可能希望从WindmillHub导入所有已批准的资源类型。设置脚本将提示您是否要每天自动同步。

环境变量

环境变量名称默认值描述适用于API服务器/工作器/全部
DATABASE_URLPostgres数据库URL。全部
WORKER_GROUPdefault工作器所属的工作组，并从中获取其配置。工作器
MODEstandalone二进制文件的模式。可能的值：standalone、worker、server全部
METRICS_ADDRNone（仅限企业版）在/metrics路径上暴露Prometheus指标的套接字地址。设置为"true"则在8001端口上暴露。全部
JSON_FMTfalse以JSON格式而不是logfmt格式输出日志。全部
BASE_URLhttp://localhost:8000公开访问您实例的基础URL。如果有实例设置，则会被覆盖。服务器
SCRIPT_TOKEN_EXPIRY900脚本开始时生成的临时令牌的默认有效期。工作器
ZOMBIE_JOB_TIMEOUT30如果工作器未发送关于正在处理作业的ping，则认为作业成为僵尸的超时时间（服务器每30秒检查一次僵尸作业）。服务器
RESTART_ZOMBIE_JOBStrue如果为true，则重启僵尸作业（使用相同的uuid和一些日志进行原地重启）；如果为false，则使僵尸作业失败。服务器
SLEEP_QUEUE50在数据库中检查新作业之间睡眠的毫秒数。它会乘以NUM_WORKERS，使得平均而言，对于一个工作器实例，每SLEEP_QUEUE毫秒有一次拉取。工作器
MAX_LOG_SIZE500000作业可以发出的最大字符数（日志+结果）。工作器
DISABLE_NUSERfalse如果启用了Nsjail，则禁用nsjail的clone_newuser设置。工作器
KEEP_JOB_DIRfalse作业完成后保留作业目录。用于调试。工作器
LICENSE_KEY（仅限企业版）NoneWindmill企业版在启动时检查的许可证密钥。工作器
S3_CACHE_BUCKET（仅限企业版）None用于同步工作器缓存的S3存储桶。工作器
SLACK_SIGNING_SECRETNoneSlack应用的签名密钥。参见Slack文档服务器
COOKIE_DOMAINNoneCookie的域。如果未设置，浏览器将根据完整的源设置Cookie。服务器
DENO_PATH/usr/bin/denoDeno二进制文件的路径。工作器
PYTHON_PATH/usr/local/bin/python3Python二进制文件的路径。工作器
GO_PATH/usr/bin/goGo二进制文件的路径。工作器
GOPRIVATE用于私有Go模块的GOPRIVATE环境变量。工作器
GOPROXY要使用的GOPROXY环境变量。工作器
NETRC用于私有Go注册表的netrc内容。工作器
PIP_INDEX_URLNone传递给pip的索引URL。工作器
PIP_EXTRA_INDEX_URLNone传递给pip的额外索引URL。工作器
PIP_TRUSTED_HOSTNone传递给pip的受信任主机。工作器
PATHNone路径环境变量，通常是继承的。工作器
HOMENone用于Go和Bash的主目录，通常是继承的。工作器
DATABASE_CONNECTIONS50（服务器）/3（工作器）数据库连接池中的最大连接数。全部
SUPERADMIN_SECRETNone允许调用者作为虚拟超级管理员superadmin@windmill.dev行事的令牌。服务器
TIMEOUT_WAIT_RESULT20'run_wait_result'端点超时前等待的秒数。工作器
QUEUE_LIMIT_WAIT_RESULTNone在'run_wait_result'端点立即拒绝请求之前队列中的最大作业数。优先于查询参数。如果未指定，则没有限制。工作器
DENO_AUTH_TOKENSNone传递给工作器以允许使用私有模块的自定义DENO_AUTH_TOKENS。工作器
DISABLE_RESPONSE_LOGSfalse禁用响应日志服务器

运行本地开发设置

仅前端

这将使用 https://app.windmill.dev 的后端，但使用您自己的前端，并支持热代码重载。

  1. 安装 caddy
  2. 进入 frontend/ 目录：
    1. 运行 npm install，npm run generate-backend-client，然后 npm run dev
    2. 在另一个shell中运行 sudo caddy run --config CaddyfileRemote
  3. 大功告成，windmill 应该可以在 http://localhost/ 访问

后端 + 前端

有关所有运行选项，请参阅 ./frontend/README_DEV.md 文件。

  1. 为Windmill创建一个Postgres数据库，并在Postgres设置中创建一个管理员角色。 获得工作数据库的最简单方法是运行 
    cargo install sqlx-cli
env DATABASE_URL=<YOUR_DATABASE_URL> sqlx migrate run
    这也将避免sqlx的 query! 宏在编译时出现问题
  2. 安装 nsjail 并确保它可以在您的PATH中访问
  3. 安装deno和python3，将二进制文件放在 /usr/bin/deno 和 /usr/local/bin/python3
  4. 安装 caddy
  5. 安装 lld linker
  6. 进入 frontend/ 目录：
    1. 运行 npm install，npm run generate-backend-client，然后 npm run dev
    2. 您可能需要为node运行时设置一些额外的堆空间 export NODE_OPTIONS="--max-old-space-size=4096"
    3. 在另一个shell中运行 npm run build，否则后端将找不到 frontend/build 文件夹并且无法编译。
    4. 在另一个shell中运行 sudo caddy run --config Caddyfile
  7. 进入 backend/ 目录： 运行 env DATABASE_URL=<DATABASE_URL_TO_YOUR_WINDMILL_DB> RUST_LOG=info cargo run
  8. 大功告成，windmill 应该可以在 http://localhost/ 访问

贡献者

<a href="https://github.com/windmill-labs/windmill/graphs/contributors"> <img src="https://contrib.rocks/image?repo=windmill-labs/windmill" /> </a>

版权

Windmill Labs, Inc 2023

编辑推荐精选

Trae

Trae

字节跳动发布的AI编程神器IDE

Trae是一种自适应的集成开发环境（IDE），通过自动化和多元协作改变开发流程。利用Trae，团队能够更快速、精确地编写和部署代码，从而提高编程效率和项目交付速度。Trae具备上下文感知和代码自动完成功能，是提升开发效率的理想工具。

AI工具TraeAI IDE协作生产力转型热门
问小白

问小白

全能AI智能助手，随时解答生活与工作的多样问题

问小白，由元石科技研发的AI智能助手，快速准确地解答各种生活和工作问题，包括但不限于搜索、规划和社交互动，帮助用户在日常生活中提高效率，轻松管理个人事务。

热门AI助手AI对话AI工具聊天机器人
Transly

Transly

实时语音翻译/同声传译工具

Transly是一个多场景的AI大语言模型驱动的同声传译、专业翻译助手，它拥有超精准的音频识别翻译能力，几乎零延迟的使用体验和支持多国语言可以让你带它走遍全球，无论你是留学生、商务人士、韩剧美剧爱好者，还是出国游玩、多国会议、跨国追星等等，都可以满足你所有需要同传的场景需求，线上线下通用，扫除语言障碍，让全世界的语言交流不再有国界。

讯飞智文

讯飞智文

一键生成PPT和Word，让学习生活更轻松

讯飞智文是一个利用 AI 技术的项目，能够帮助用户生成 PPT 以及各类文档。无论是商业领域的市场分析报告、年度目标制定，还是学生群体的职业生涯规划、实习避坑指南，亦或是活动策划、旅游攻略等内容，它都能提供支持，帮助用户精准表达，轻松呈现各种信息。

AI办公办公工具AI工具讯飞智文AI在线生成PPTAI撰写助手多语种文档生成AI自动配图热门
讯飞星火

讯飞星火

深度推理能力全新升级，全面对标OpenAI o1

科大讯飞的星火大模型，支持语言理解、知识问答和文本创作等多功能，适用于多种文件和业务场景，提升办公和日常生活的效率。讯飞星火是一个提供丰富智能服务的平台，涵盖科技资讯、图像创作、写作辅助、编程解答、科研文献解读等功能，能为不同需求的用户提供便捷高效的帮助，助力用户轻松获取信息、解决问题，满足多样化使用场景。

热门AI开发模型训练AI工具讯飞星火大模型智能问答内容创作多语种支持智慧生活
Spark-TTS

Spark-TTS

一种基于大语言模型的高效单流解耦语音令牌文本到语音合成模型

Spark-TTS 是一个基于 PyTorch 的开源文本到语音合成项目，由多个知名机构联合参与。该项目提供了高效的 LLM（大语言模型）驱动的语音合成方案，支持语音克隆和语音创建功能，可通过命令行界面（CLI）和 Web UI 两种方式使用。用户可以根据需求调整语音的性别、音高、速度等参数，生成高质量的语音。该项目适用于多种场景，如有声读物制作、智能语音助手开发等。

咔片PPT

咔片PPT

AI助力，做PPT更简单！

咔片是一款轻量化在线演示设计工具，借助 AI 技术，实现从内容生成到智能设计的一站式 PPT 制作服务。支持多种文档格式导入生成 PPT，提供海量模板、智能美化、素材替换等功能，适用于销售、教师、学生等各类人群，能高效制作出高品质 PPT，满足不同场景演示需求。

讯飞绘文

讯飞绘文

选题、配图、成文，一站式创作，让内容运营更高效

讯飞绘文，一个AI集成平台，支持写作、选题、配图、排版和发布。高效生成适用于各类媒体的定制内容，加速品牌传播，提升内容营销效果。

热门AI辅助写作AI工具讯飞绘文内容运营AI创作个性化文章多平台分发AI助手
材料星

材料星

专业的AI公文写作平台，公文写作神器

AI 材料星，专业的 AI 公文写作辅助平台，为体制内工作人员提供高效的公文写作解决方案。拥有海量公文文库、9 大核心 AI 功能，支持 30 + 文稿类型生成，助力快速完成领导讲话、工作总结、述职报告等材料，提升办公效率，是体制打工人的得力写作神器。

openai-agents-python

openai-agents-python

OpenAI Agents SDK，助力开发者便捷使用 OpenAI 相关功能。

openai-agents-python 是 OpenAI 推出的一款强大 Python SDK，它为开发者提供了与 OpenAI 模型交互的高效工具，支持工具调用、结果处理、追踪等功能，涵盖多种应用场景，如研究助手、财务研究等，能显著提升开发效率，让开发者更轻松地利用 OpenAI 的技术优势。

下拉加载更多