{"id":13520938,"url":"https://github.com/MercuryWorkshop/anuraOS","last_synced_at":"2025-03-31T20:30:30.780Z","repository":{"id":193150745,"uuid":"555552624","full_name":"MercuryWorkshop/anuraOS","owner":"MercuryWorkshop","description":"A web \"OS\" and development environment with full linux emulation","archived":false,"fork":false,"pushed_at":"2025-03-27T04:47:45.000Z","size":302502,"stargazers_count":304,"open_issues_count":11,"forks_count":402,"subscribers_count":16,"default_branch":"main","last_synced_at":"2025-03-29T17:13:56.315Z","etag":null,"topics":["linux","v86","webos"],"latest_commit_sha":null,"homepage":"https://anura.mercurywork.shop","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MercuryWorkshop.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-10-21T20:15:20.000Z","updated_at":"2025-03-27T08:52:48.000Z","dependencies_parsed_at":"2023-09-24T05:14:15.275Z","dependency_job_id":"c1ab6693-8baa-4939-a70f-0d6698c7ddb1","html_url":"https://github.com/MercuryWorkshop/anuraOS","commit_stats":null,"previous_names":["mercuryworkshop/alicewm"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MercuryWorkshop%2FanuraOS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MercuryWorkshop%2FanuraOS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MercuryWorkshop%2FanuraOS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MercuryWorkshop%2FanuraOS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MercuryWorkshop","download_url":"https://codeload.github.com/MercuryWorkshop/anuraOS/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246535711,"owners_count":20793311,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["linux","v86","webos"],"created_at":"2024-08-01T06:00:24.732Z","updated_at":"2025-03-31T20:30:30.772Z","avatar_url":"https://github.com/MercuryWorkshop.png","language":"JavaScript","funding_links":[],"categories":["Applications"],"sub_categories":["Webtops / Web OSes"],"readme":"![AnuraOS logo](/assets/logo_dark.png#gh-light-mode-only)\n![AnuraOS logo](/assets/logo_light.png#gh-dark-mode-only)\n\nThe next-gen webOS and development environment with full Linux emulation.\n\n---\n\n## What is AnuraOS?\n\nAn entirely local browser-based \"OS\" and development environment with complete graphical Linux emulation, visually based on ChromiumOS. See a demo [here](https://anura.pro), fully in your browser.\n\n\u003e [!WARNING]  \n\u003e Anura mainly targets Chromium but should work on most browsers. For a list of known browser specific quirks check [this document](BrowserQuirks.md).\n\nAnura uses the features of a PWA (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!\n\nAnura 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.\n![](/assets/showcase.png)\n\n## Development\n\n\u003e [!IMPORTANT]  \n\u003e Anura will not build on Windows. Please use a Linux VM or WSL.\n\n### Easy Install for GitHub Codespaces\n\n- Run `source codespace-basic-setup.sh`\n\n\u003e [!NOTE]\n\u003e\n\u003e - If you are not in a codespace skip to the regular installation steps.\n\u003e - This does NOT build RootFS.\n\n### Dependencies\n\n- Recent versions of `node.js` and `npm`\n- `wget`\n- A recent version of `java` (11+)\n- `inotifytools`\n- `rustup`\n- `wasm-opt`\n- `make`\n- `gcc` (`gcc-multilib` on Debian and Ubuntu x86_64)\n- 32 bit version of `glibc` (needed for building rootfs, `lib32-glibc` on Arch Linux)\n- `clang`\n- `uuid-runtime`\n- `jq`\n- `docker`\n- An x86(-64) Linux PC (`make rootfs-alpine` build depends on x86 specific tools)\n\n\u003e [!NOTE]\n\u003e You will have to install the required Rust toolchain by running `rustup target add wasm32-unknown-unknown` and also `rustup target add i686-unknown-linux-gnu` if you are planning to build v86 images.\n\n#### Building\n\n- Clone the repository with `git clone --recursive https://github.com/MercuryWorkshop/anuraOS`\n- Then, `make all`\n\n\u003e [!TIP]\n\u003e You can use `make all -B` instead if you want to force a full build.\n\n### Building the Linux RootFS\n\n- Make sure you have `Docker` installed and running.\n- Make sure to add yourself to the Docker group using `usermod -a -G docker $USER`\n- Run `make rootfs`\n\n### Running Anura Locally\n\nYou can run Anura with the command\n\n```sh\nmake server\n```\n\nAnura should now be running at `localhost:8000`.\n\n## App Development\n\nApp development is highly encouraged! Good apps can even be added to the official app repositories after review by an AnuraOS maintainer. Apps are stored in .app files which are read by AnuraOS to provide you, well, an app!\n\nFor more information about developing an AnuraOS app please visit [this page](./documentation/appdevt.md) and for using Anura API's in your code, please visit [this page](./documentation/Anura-API.md).\n\n## Documentation\n\nSee the current index of documentation [here](./documentation/README.md).\n\n## Security\n\nSee [SECURITY.md](./SECURITY.md) for reporting instructions.\n\n## Credits\n\nAnuraOS is created by [Mercury Workshop](https://mercurywork.shop). Linux emulation is based off of the [v86](https://github.com/copy/v86) project. For more credits, see [CREDITS.MD](./CREDITS.md).\n\n(p.s. for hackers: the entrypoint to anura is [src/Boot.tsx](./src/Boot.tsx))\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMercuryWorkshop%2FanuraOS","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FMercuryWorkshop%2FanuraOS","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMercuryWorkshop%2FanuraOS/lists"}