welsonjs

WelsonJS logo with four diagonal stripes in red, green, blue, and yellow, overlaid with the letters JS. WelsonJS - Built-in JavaScript for Industrial Automation on Windows.

Cover Art: Windows in 1999, Art by @_bag0@x.com

FOSSA Status AppVeyor Status DOI 10.5281/zenodo.11382384 ChatGPT available Google Gemini available slideshare.net presentation YouTube promotion video Discord chat G2 Product Hunt Trustpilot Open to work Ask DeepWiki MCP Powered by OrcaRouter

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

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
GUI environment
Command-line environment
Command-line environment
WelsonJS with Microsoft Excel
WelsonJS with Microsoft Excel
Write a Windows Service with JavaScript
Write a Windows Service with JavaScript
Template Matching on the computer screen
Template Matching on the computer screen
The Launcher for WelsonJS Application Packages
The Launcher for WelsonJS Application Packages
Microsoft Monaco Editor on WelsonJS Launcher
Microsoft Monaco Editor on WelsonJS Launcher
You can run a .js file just like an executable by simply double-clicking it.
You can run a .js file just like an executable by simply double-clicking it.

Product Hunt

WelsonJS was featured on Product Hunt on September 9th, 2026, at 12:01 AM PDT.

WelsonJS on Product Hunt

Dev Tools Dir

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

WelsonJS on Dev Tools Dir

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

Use Cases

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

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

How to release my application?

The WelsonJS framework suggests the following application release methods:

Collaborations

Thanks to

Subprojects

Join the community

I am always open. Collaboration, opportunities, and community activities are all welcome.

Support Contact

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.

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.