Lua-based operating system, based on LuPI2, with a focus on PowerPC based Macintosh machines
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Łukasz Magiera 872775d9e4 Add unifont license 7 years ago
include Merge branch 'master' into framebuffer 7 years ago
resources framebuffer support 7 years ago
scripts Windows port(wingw cross compiler targets) 7 years ago
src Merge branch 'master' into framebuffer 7 years ago
.gitattributes Improved performance 7 years ago
.gitignore Improved Makefile and Gitignore. 7 years ago
LICENSE Update LICENSE 7 years ago
LICENSE-unifont Add unifont license 7 years ago
Makefile Windows port(wingw cross compiler targets) 7 years ago Improve dependency building a bit 7 years ago


Second attempt at Lua based operating system, primarily aimed at RaspberryPi, but with ambition to support other boards as well. The main motivation is fact that GNU/Linux + python solution isn't allays the best for people that haven't been programming ever, and Lua in one of the simplest, most intuitive languages. It has only 6 types, very simple syntax, yet supports many advanced mechanisms.


  1. Clone this repository
  2. Get musl cross compiler(like arm-linux-musleabihf), simplest way is to use musl-cross
  3. Get xxd utility (usually packaged with vim)
  4. Build dependencies using scripts/ script for your platform(s)
  5. Execute make build
  6. You will need to put some OS to root directory where you run the binary. For now you can get plan9k at

In case of problems poke me/someone at #lupi on Freenode


Design of system APIs is heavily influenced by OpenComputers minecraft mod. Some Lua code parts are actually copied from there (all of the code is under the MIT License). Main advantage of the API is that it's event/component based, which provides great level of abstraction. Custom components can be created and used with very little effort, being event-based simplifies code further, providing one unified queue for events instead of multiple ways of handling them.

local component = require("component")

--Create virtual LED component using built-in GPIO component
local led = {}
led.toggle = function() component.gpio.togglePin(27) end
component.register(nil, "LED", led)

--Blink the LED
while true do


On the low-level side LuPI will run on very stripped-down version of Linux kernel as init, it will be the only binary executable in system. Kernel will only provide hardware drivers and abstract some of the things. Entire userspace is meant to be done using Lua. Security isn't the primary goal but still needs to be considered.

Get involved

There are many ways you can help.

  • Report issues
  • Contribete via pull requests
  • Talk on IRC (#lupi on Freenode)