human-language 0.1.5

A custom programming language with plain English syntax

Human Programming Language

Created and owned by KielTech

A human-friendly programming language with plain English syntax.

Overview

Human is an interpreted/compiled language that prioritizes readability and naturalness. It uses plain English constructs with minimal keywords.

File Extension

.hm - Human Language files

Quick Example

print "Hello, World!"

set age to 25
if age is greater than 18
    print "You are an adult"
end if

define greet with name
    print "Hello, " + name + "!"
end define

greet "Alice"

Installation & Usage

Install Human

Install the published runtime from PyPI:

pip install human-language

Run a program

human program.hm

Start the REPL

human --repl

Quick Hello World

print "Hello, World!"

Standalone release download

A standalone Windows runtime is now available from the GitHub release for v0.1.4:

https://github.com/kieltech75-hue/Human/releases/tag/v0.1.4

Download the human.exe asset directly:

https://github.com/kieltech75-hue/Human/releases/download/v0.1.4/human.exe

human.exe is self-contained and requires no Python install.

Android packaging

Build an Android APK using the provided helper:

human --package-apk --spec buildozer.spec --target debug

Key Features

• Natural English-style syntax for control flow, functions, and declarations
• Built-in data types: strings, numbers, lists, dictionaries, booleans
• Imports for reusable .hm modules
• Simple class-style objects and method calls
• File I/O, environment access, and logging
• HTTP helpers for services and web endpoints
• Python interoperability via py_import and py_call
• REPL with package manager commands and debugging helpers

Common commands

• human program.hm — execute a Human program
• human --repl — launch the interactive REPL
• human --package-native <source.hm> --dist <output-dir> — build a native executable
• human --package-native <source.hm> --dist <output-dir> --bundle-python --name <app-name> — build a self-contained executable
• human --package-apk --spec buildozer.spec --target debug — build an Android APK

REPL package manager commands

• :install <package> [--global] — install a local or Git-hosted Human module
• :list-packages [--global] — list installed Human packages
• :remove <package> [--global] — remove an installed package
• :pkg-info <package> — show the package install path
• :reload <module> — reload an imported module
• :paths — show trusted module search roots
• :vars — show current REPL variables
• :stack — show the current VM stack
• :pc — show the current VM program counter
• :debug <file> — launch the interactive debugger for a file
• :license — display license text

Examples

Run the AI example:

human examples/ai_app.hm

Run the web app example:

human examples/web_app.hm

Run the production website example with sessions, templates, logging, static assets, and deployment hooks:

human examples/production_web_app.hm

Syntax Highlighting

The Human VS Code extension provides syntax highlighting, bracket matching, and .hm file support.

Install the published extension from the Visual Studio Marketplace or use the local VSIX package from this repository.

Learn more

For additional usage examples and reference guides, see:

• INSTALLATION.md
• QUICKSTART.md
• QUICK_REFERENCE.md
• SYNTAX.md