nodus-lang 2.0.0

A stack-VM scripting language and distributed workflow runtime

Nodus

pip install nodus-lang
nodus init
nodus run
nodus repl

Nodus is a bytecode-compiled scripting language and runtime created by Shawn Knight as part of the Masterplan Infinite Weave ecosystem. It implements the Infinity Algorithm's execution model as a first-class language construct, expressed through coroutines, task graphs, workflows, and goals on a deterministic stack-based VM.

For a machine-readable project index see llms.txt.

Install

Requires Python 3.10+.

pip install nodus-lang

For the optional FastAPI/Uvicorn server stack:

pip install "nodus-lang[server]"

Quick Start

Create a project:

mkdir my-app
cd my-app
nodus init
nodus run

nodus init creates nodus.toml and src/main.nd.

nodus run executes the current project's src/main.nd when run inside a project root.

Start the REPL:

nodus repl

Useful REPL commands:

• :help shows REPL commands.
• :quit exits the REPL.

Run A File

Create hello.nd:

print("hello")

Run it explicitly:

nodus run hello.nd

When you provide a file path, Nodus runs only that file. When you run nodus run with no file inside a project, Nodus runs only src/main.nd.

Common Commands

• nodus --version
• nodus run hello.nd
• nodus run
• nodus repl
• nodus check hello.nd
• nodus check
• nodus fmt hello.nd

Standard Library

Import standard library modules with the std: prefix:

import "std:math" as math
print(math.abs(-4))

Documentation

• Language Specification — full syntax, types, control flow, imports, coroutines
• Architecture — runtime pipeline and module system
• Changelog — version history
• Contributing — development setup, code style, and contribution process
• llms.txt — machine-readable project index for AI tools

<script type="application/ld+json"> { "@context": "https://schema.org", "@type": "SoftwareApplication", "name": "Nodus", "description": "A bytecode-compiled scripting language and distributed workflow runtime implementing the Infinity Algorithm as a first-class language construct.", "author": { "@type": "Person", "name": "Shawn Knight", "url": "https://github.com/Masterplanner25" }, "applicationCategory": "DeveloperApplication", "programmingLanguage": "Python", "operatingSystem": "Linux, macOS, Windows", "url": "https://github.com/Masterplanner25/nodus-lang", "downloadUrl": "https://pypi.org/project/nodus-lang/", "license": "https://spdx.org/licenses/MIT.html", "version": "2.0.0", "softwareRequirements": "Python >= 3.10" } </script>