windmill-labs /windmill

Code-first platform for workflows, apps and AI agents, on the fastest self-hostable orchestrator (benchmarked against Airflow, Prefect and Temporal). Business teams build with AI, engineers control what ships. Open-source alternative to Lovable, Retool and n8n.

★ 18,601⑂ 1,158👁 51⑃ 10,597● 1,684▤ 1,605
RustNOASSERTIONCreated 2022-05-05windmill.dev
Download: v1.875.0v1.875.0 ↓1.875.02026-11-14
+13
Daily
18,601
stars
1,158
forks
51
watchers
10,597
prs
1,684
issues
1,605
releases

README

Open-source, self-hostable code-first platform for workflows, apps and AI agents, running on the fastest self-hostable orchestrator. Engineers write code in 20+ languages and sync it with Git. Business teams build on the same platform with AI, while review, promotion between environments and isolated workers keep engineers in control of what ships. Self-hostable alternative to Lovable, Retool, n8n and a simplified Temporal.


Scripts are turned into sharable UIs, APIs and cron jobs automatically, and can be composed together into flows, data pipelines, AI agents or full-code React and Svelte apps. Supported languages: Python, TypeScript, Go, Bash, SQL, GraphQL, PowerShell, Rust, and more.




    


    


    





    


  




  Try it - Website - Docs - Discord - Hub - Contributing


 Windmill - Code-first platform for workflows, apps and AI agents

Windmill is fully open-sourced (AGPLv3) and Windmill Labs offers dedicated instances and commercial support and licenses.

!Windmill Diagram

https://github.com/user-attachments/assets/d80de1d9-64de-4d89-aacd-6df23fa81fc4

- Windmill - Code-first platform for workflows, apps and AI agents
  - Build with AI, ship with review
  - Main Concepts
  - What the code looks like
  - Data: data tables, DuckDB and DuckLake
  - Develop locally or in the browser
  - Stack
  - Fastest Self-Hostable Workflow Engine
  - Security
  - Performance
  - Architecture
  - How to self-host
    - Docker compose
    - Kubernetes (Helm charts)
    - Cloud providers
    - OAuth, SSO \& SMTP
    - License
    - Integrations
  - Environment Variables
  - Contributing
  - Copyright

 Build with AI, ship with review

Business teams and engineers build on the same Windmill instance. What the AI builds is an ordinary script, flow or app, and goes through the same review as code written by engineers:

- AI sessions build scripts, flows and apps with AI in a workspace fork, with a live preview and a diff to review before deploying.
- Workspace roles decide what each team can author, and folders scope the resources, skills and MCP servers its AI can reach.
- Protection rulesets block direct deployment, so changes reach production only after an engineer reviews and deploys them.
- Dev workspaces keep their own credentials, and promote to prod through Compare & Deploy or a Git pull request.
- Worker groups run AI-built code on its own workers, or on a separate instance.

See let business teams build with AI safely for the full setup. Engineers keep writing code locally with the CLI, the VS Code extension and their coding agent, synced with Git.

 Main Concepts

1. Define a minimal and generic script in Python, TypeScript, Go or Bash that solves a specific task. The code can be defined in the provided Web IDE or synchronized with your own GitHub repo (e.g. through VS Code extension): provided Web IDE or synchronized with your own GitHub repo (e.g. through VS Code extension):

!Step 1

2. Your scripts parameters are automatically parsed 

Top issues

Discussions

Latest release

v1.875.0 v1.875.0 2026-11-14
1.875.0 (2026-11-14)


 Features

 exact start and end of a fairness cap in its alerts (12438) (df0e5cf)
 fairness reserve as a worker group setting, shown on the workers page (12435) (5f8e002)
 show long step durations in hours and minutes on run timelines (12437) (c6955ed)


 Bug Fixes

 keep shortcuts from opening home filters over global search (12439) (d09336d)

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON