welsonjs
WelsonJS - Built-in JavaScript for Industrial Automation on Windows.


Now, you can build, automate, and orchestrate Windows applications and industrial systems using JavaScript, transpiled languages such as TypeScript, CoffeeScript, and ReScript, and HTML/CSS, all powered by the built-in ECMAScript engine.
WelsonJS = Windows + Electron-like + Javascript(JS) + :heart:Contributions
- :rocket: Deploy on Microsoft Azure Marketplace (Available again soon)
- :kissing_cat: Download the WelsonJS Launcher
- :shell: In PowerShell:
irm https://catswords.blob.core.windows.net/welsonjs/bootstrap.ps1 | iex
Note: The default license for this project is GPL 3.0. However, if the GPL 3.0 license is not compatible with Microsoft products, it is subject to the MS-RL license.
Screenshots
 GUI environment |  Command-line environment |
 WelsonJS with Microsoft Excel |  Write a Windows Service with JavaScript |
 Template Matching on the computer screen |  The Launcher for WelsonJS Application Packages |
 Microsoft Monaco Editor on WelsonJS Launcher |  You can run a .js file just like an executable by simply double-clicking it. |
Featured
Product Hunt
WelsonJS was featured on Product Hunt on September 9th, 2026, at 12:01 AM PDT.

WelsonJS was featured on Dev Tools Dir on Sunday, November 1, 2026 at 08:00 AM UTC

Why Choose WelsonJS?
WelsonJS is an advanced JavaScript framework designed to operate in extreme conditions where conventional solutions may fail. Unlike traditional JavaScript frameworks, WelsonJS focuses on executing scripts in constrained environments, ensuring reliable performance even with minimal system resources.
Key Features
- Lightweight and Efficient: Optimized for environments with limited computing power, WelsonJS delivers efficient script execution without unnecessary overhead.
- Windows ECMAScript Compatibility: Designed to run seamlessly on Windows-based systems, adhering to the ECMAScript standard while maintaining lightweight execution.
- Standalone Execution: Unlike well-known JavaScript runtimes, which require external dependencies, a WelsonJS application can operate as a self-contained app, making it suitable for embedded systems and isolated environments.
- Security-Oriented: Built with security in mind, ensuring controlled execution of scripts without compromising system integrity.
- Minimalist Design: WelsonJS strips away unnecessary complexities, focusing on core functionalities that maximize performance and reliability.
Use Cases
- Legacy System Integration: WelsonJS provides a practical solution for running JavaScript on older Windows environments where modern frameworks are not feasible.
- Automation and Scripting: Ideal for executing scripts in constrained environments, enabling automated workflows and system-level scripting.
- Embedded Applications: Suitable for devices and systems with strict resource constraints, such as industrial controllers and embedded platforms.
- Security-Focused Environments: Useful in security-sensitive applications where dependencies on external network connections are limited.
- 🎬 Office Automation: Suitable for office automation tasks using Microsoft Office (Excel, PowerPoint, Word, Outlook) and various LLM AI (ChatGPT, Claude).
WelsonJS is tailored for developers who need a reliable, lightweight JavaScript framework in environments where traditional solutions are impractical. Whether working with legacy systems, embedded devices, or security-critical applications, WelsonJS ensures that JavaScript remains a viable and efficient option.
System Requirements
- Operating Systems: Windows XP SP3 or later (Currently, Windows 11 24H2)
- For systems running Windows 2000 or earlier versions (e.g., 95, 98, Me), please contact us separately.
Structure
Every way of starting WelsonJS ends in the same runtime, app.js, which loads the entry script and the modules it require()s. The modules reach Windows through COM and WSH, external programs and remote services. Those that use local AI call the WelsonJS Launcher’s HTTP API.
flowchart LR
subgraph Start["Ways to start"]
Console(["Console<br/>cscript app.js name"])
Click(["Double-click a .js file<br/>(JCTG)"])
Uri(["welsonjs:// URI"])
Hta(["app.hta window"])
Mcp(["MCP client<br/>(stdio)"])
Service["WelsonJS.Service<br/>(Windows service)"]
end
App["app.js<br/>runtime and require()"]
subgraph Entry["Entry scripts"]
Script["name.js<br/>(your script)"]
Web["webloader.js"]
UriLoader["uriloader.js"]
McpLoader["mcploader.js"]
end
Page["index.html, index.js,<br/>style.css"]
Modules["lib/*.js modules"]
subgraph Host["Windows and outside"]
Com["COM, WSH, WMI,<br/>registry, Office"]
Managed["WelsonJS.ManagedObject<br/>and other .NET modules"]
Programs["External programs<br/>(curl, ADB, Chrome...)"]
Cloud["Remote services<br/>(cloud AI, web APIs)"]
end
subgraph Launcher["WelsonJS Launcher"]
Instances["Instances, editor,<br/>settings"]
Api["HTTP API<br/>localhost:3000"]
Local["llama.cpp, CrispEmbed,<br/>LLM guard"]
Chakra["ChakraCore<br/>(via Phantomizer)"]
end
Console --> App
Click --> App
Uri --> App
Hta --> App
Mcp --> App
Service -->|"ScriptControl (JScript)"| App
Instances -->|"cscript app.js"| App
App -->|"require()"| Script
App --> Web
App --> UriLoader
App --> McpLoader
Web -->|"present"| Page
Page -.->|"shown in"| Hta
Script --> Modules
Web --> Modules
UriLoader --> Modules
McpLoader --> Modules
Modules --> Com
Modules --> Managed
Modules --> Programs
Modules --> Cloud
Modules -->|"lib/llamacpp.js, crispembed.js,<br/>llm-guard.js"| Api
Api --> Local
Api --- Chakra
Quick start
1. Write a file lib/sayhello.js
// lib/sayhello.js
function say() {
console.log("hello");
}
exports.say = say;
exports.VERSIONINFO = "SayHello (sayhello.js) version 0.1";
exports.AUTHOR = "gnh1201@catswords.re.kr";
exports.global = global;
exports.require = global.require;
2. Write a file sayhello.js
// sayhello.js
var SayHello = require("lib/sayhello");
function main() {
console.log("calling say()");
SayHello.say();
console.log("ended say()");
}
exports.main = main;
3. Execute script on the console
C:\Users\JohnDoe\Documents\GitHub\welsonjs> cscript app.js sayhello
calling say()
hello
ended say()
Documentation
More guides are in the docs folder:
Specifications
- Built-in transpilers: TypeScript, Rescript, CoffeeScript 2, LiveScript
- Ready to use on Windows machine immediately. No additional software installation is required.
- WelsonJS Launcher: Manage instances (Like a container), User-defined variable editor, Microsoft Monaco Editor and React (Pre-embedded rich code editor), Microsoft Copilot, and Azure AI Services, Network tools (Whois, DNS Query, Criminal IP CTI) on the code editor.
- ES5(ECMAScript 5), XML, JSON, YAML compatibility: core-js, JSON2.js, js-yaml
- HTML5 compatibility on the built-in HTML rendering engine: html5shiv, jquery-html5-placeholder-shim, Respond, selectivizr, ExplorerCanvas, Modernizr
- Classical CSS Frameworks: cascadeframework, golden-layout
- WYSIWYG HTML Editor: summernote
- Included libraries: jQuery, jQuery UI, jquery-toast-plugin, squel, jsrender, linq, pegjs, numbers.js
- Compatible with modern JavaScript specifications: module.exports, CommonJS, UMD compatibility, NPM(Node Package Manager) compatibility
- Supports device debugging protocol clients: Chrome DevTools Protocol, ADB(Android Debug Bridge)
- RPC(Remote Procedure Call) protocol clients: gRPC, JSON-RPC 2.0
- Various types of HTTP clients: XHR(MSXML), cURL, BITS, CERT, Web Proxy, SEO/SERP
- WelsonJS.ManagedObject: A native module for Windows Service applications, window handle control, bitmap manipulation, virtual mouse and keyboard events, and Named Shared Memory-based IPC.
- AI integrations:
- Cloud providers: OpenAI (ChatGPT), Anthropic, xAI, Google Gemini, Mistral AI, DeepSeek, Moonshot AI, and NAVER CLOVA Studio.
- Cloud AI gateways and multi-model platforms: OrcaRouter for model routing, CheaperInference for OpenAI-compatible multi-provider model routing, UberLLM for OpenAI-compatible access to many vendors’ chat models with one prepaid key, Groq and FriendliAI for hosted multi-model inference, and Alibaba Cloud Model Studio (Qwen) for Qwen and third-party model APIs.
- Local: Optional llama.cpp inference with GGUF models, including Hy-MT2 1.8B 1.25-bit (Tencent AngelSlim) for machine translation FrogNano 4B 2609 for SWE, and BitNet b1.58 2B-4T (Microsoft, 1.58-bit); downloads require internet, while inference runs on-device.
- Aviation Data integrations: AviationStack, SerpApi Google Flights API
- OVFTool (VMware) integration: OVFTool for Broadcom/VMware infrastructures
- :fire: NEW! Windows built-in database engine, aka. ESENT (ESE) database interface library (WelsonJS.Esent)
- :fire: NEW! WelsonJS JCTG(JavaScript-Click-To-Go): Run WelsonJS script files written in JavaScript directly from Windows File Explorer with a (double) click. Just like an
.exe file.
- :fire: NEW! WelsonJS MCP(Model Context Protocol)
- Everything you can imagine.
How to release my application?
The WelsonJS framework suggests the following application release methods:
- Compress to Zip, and use the launcher: Compress the files and directories necessary for running the project into a Zip file, and distribute it along with the WelsonJS Launcher.
- Build a setup file: Use Inno Setup. The setup profile (the
setup.iss file) is already included.
- Use PowerShell: For example,
irm https://catswords.blob.core.windows.net/welsonjs/bootstrap.ps1 | iex
- Copy all directories and files: This is the simplest and most straightforward method.
Collaborations
Thanks to
- :heart: Artwork (Logo image): @druidesse
- :heart: Artwork (Cover image): @_bag0@x.com
- :heart: Special Contributors: @hcho3, :octocat: GitHub Sponsors
- :sunglasses: Heavy-industry specialized CSP(Cloud Service Provider) in Republic of Korea - Use case development
- :sunglasses: Live-commerce specialized online advertisement companies in Republic of Korea - Use case development
- :sunglasses: Information security companies in Republic of Korea - Use case development
- :sunglasses: Travel planning(e.g., Airlines, Hotels, Ticketing) related companies - Use case development
- :sunglasses: Probability-based game prediction in a data analytics company - Use case development
- :sunglasses: Qiita - Knowledge-base about WSH environment
- :sunglasses: Redsky Software - PoC(Proof of Concept) of the CommonJS on WSH environment
- :sunglasses: Inspired by a small-sized JavaScript payload demonstrated by a cybersecurity related group.
- :sunglasses: Inspired by the use of Named Shared Memory in a cross-runtime IPC implementation written by the unidentified developer.
- :eyes: Hacker News, Node Weekly (#​582 - June 17, 2025), WebToolsWeekly, GeekNews in GeekNews Weekly (2024-09-30 ~ 2024-10-06), Facebook Group “Javascript Programming”(javascript4u), morioh.com, CSDN, Fediverse, daily.dev, PitchHut, Disquiet, Zhouexin (周e信), Echo JS, Telegram Channel @front_end_dev, React Status
Subprojects
I am always open. Collaboration, opportunities, and community activities are all welcome.
For offline copy requests, consulting, mentoring, and technical support inquiries, please check this link.
Report abuse
Open-source software license
For detailed information on the open-source license status of this project, please refer to FOSSA Status.

Disclaimer
To the maximum extent permitted by applicable law, Namhyeon Go and Catswords Research shall not be held liable for any direct, indirect, incidental, special, or consequential damages arising out of or in connection with the use of this software outside its intended purpose or scope.