Skip to content

anuraOS

AnuraOS logo

The next-gen webOS and development environment with full linux emulation.

Quality Gate Status Lines of Code


What is AnuraOS?

An entirely local browser “OS” and development environment with complete graphical linux emulation, visually based on chromiumOS. See a demo here, fully in your browser.

Anura uses the features of a progressive web app to make its environment work fully offline, providing a virtual filesystem (synced with the linux emulator), a code editor, and a modular and extensible app system. You can even edit Anura’s code live while inside of it!

Anura shows as more of a proof-of-concept with what’s possible on the modern web rather than an actual product. However, it proves useful in many actual cases and is a useful educational tool.

Development

Easy Install for GitHub Codespaces

  • Run source codespace-basic-setup.sh

Dependencies

  • Recent versions of node.js and npm
  • wget
  • A recent version of java (11+)
  • inotifytools
  • rustup
  • wasm-opt
  • make
  • gcc (gcc-multilib on Debian and Ubuntu x86_64)
  • clang
  • uuid-runtime
  • jq
  • docker
  • An x86(-64) Linux PC (make rootfs-alpine build depends on x86 specific tools)

Building

Terminal window
git clone --recursive https://github.com/MercuryWorkshop/anuraOS
make all

Building the Linux RootFS

  • Make sure you have Docker installed and running.
Terminal window
make rootfs
usermod -a -G docker $USER

Running Anura Locally

You can run Anura with the command

Terminal window
make server

Anura should now be running at localhost:8000.

Documentation

See the current index of documentation here.

Security

See SECURITY.md for reporting instructions.

Credits

AnuraOS is created by Mercury Workshop. Linux emulation is based off of the v86 project