Introduction

Joule — Joule — self-hosted energy-aware programming language with compile-time energy budgets.

This is the official documentation for Joule. The full source code lives in the private -core mirror; the public release surface is at openIE-dev/joule-lang.

What you'll find here

• Install — get the joulec binary on your machine
• Hello, Joule — first program in 30 seconds
• Tutorial — a 30-minute hands-on guided tour
• Reference — every feature, every flag, every API
• Cookbook — task-oriented recipes
• Design — why Joule exists and how it fits with the rest of openIE-dev

The openIE-dev ecosystem

Joule is one of five public openIE-dev projects. All five share a common substrate (flowG) and energy-metering layer (substrate-energy):

• flow-g — the IR + runtime substrate
• lux-lang — reactive language compiling to flowG
• jmax — math-native language
• joule-lang — energy-budgeted compiled language
• jouledb — energy-metered database

License

Joule binaries are distributed under BSL-1.1. Documentation under CC-BY-4.0. Examples under Apache-2.0.