@edryslabs/edrys-lite
v3.2.2
Published
Browser-based, peer-to-peer remote labs and live classrooms (WebRTC or WebSocket, synced with Yjs)
Readme
edrys-Lite: Revolutionizing Remote Laboratories

Welcome to edrys-Lite, the cutting-edge open-source project designed to revolutionize how we create and share remote laboratories. In a world where education and research are increasingly moving online, edrys-Lite provides an intuitive and simplistic way for users to engage with laboratory environments directly from their browser -- no servers required.
Introduction
Inspired by @edrysorg, which is unfortunately not under active development, edrys-Lite aims to provide a serverless peer-to-peer approach for remote laboratories. By leveraging the latest web technologies, such as WebRTC for real-time, peer-to-peer connections, and CRDTs (Yjs) for collision free state handling, edrys-Lite offers a seamless, serverless experience for users worldwide. Where WebRTC is blocked, a classroom can switch to a WebSocket relay instead.
Whether you're a student, educator, researcher, or enthusiast, edrys-Lite invites you to explore, contribute, and grow with us. Together, we can unlock new realms of possibility and innovation in the digital age.
✨ Features
Live Classrooms: Live chat, create rooms, and interact in different modules
Remote Labs: Allow students to interact with your real lab equipment remotely & asynchronously
Modular: Build your class by combining Modules or make your own with an easy real-time API
Easy to start: Entirely browser-based, no hosting, no backend, no databases or any other dependencies to set up
Privacy-friendly: Passwordless auth with autogenerated user-ids, without any tracking or data collection
Signed and verified: Every user is a key pair created in the browser. Classroom setup, rooms, chat and presence are signed and checked by every peer, and an optional members list decides who may join and who teaches
Fast & Modern: Based on a modern peer-2-peer approach with Conflict-free-Replicated-DataTypes (CRDTs) and deliberately small codebase
Free and Open Source, forever: No paywall features or lock-in
📸 Demo
https://github.com/edrys-labs/edrys-Lite/assets/3089101/b7188ba0-b91e-469c-8a9f-413229683bcc
💡 Use cases
Live online teaching: One to one, one to many, and many to many live classrooms
Remote Labs: Allow students to access and control live equipment remotely (eg. remote Arduino fleet)
Flipped classrooms and blended learning: Create modules to deliver virtually any content asynchronously
Group coursework: Dynamic breakout rooms and easy jumping between rooms, or a class where only teachers move students between rooms and stations
📚 Documentation
For more information, please refer to the official documentation, also available as a LiaScript course.
🧪 Building labs and modules locally
edrys-dev runs edrys-Lite on your own machine and keeps a class in step with a lab file: save lab.yml and the class updates in every open tab. Modules you are writing reload on save, too.
npm install -g @edryslabs/edrys-dev
edrys-dev lab.yml --openAn AI agent such as Claude Code can start it too (edrys-dev --mcp, from the lab folder's .mcp.json; see the edrys-dev README). The agent then edits the lab, sees the live class (rooms, users, module messages, errors) and talks to you in a chat panel on top of it. The edrys skills teach the agent how to write labs and modules.
🛠️ Development
Requires Node.js and npm.
npm install
npm run watch # dev server on http://localhost:6999
npm run build # production build into dist/
npm run websocket-server # local edrys WebSocket relay on ws://localhost:1234 (the class's WebSocket URL)Tests:
npm test # unit tests (Vitest)
npm run test:e2e # end-to-end tests (Playwright) over WebRTC
npm run test:e2e:ws # the same tests over WebSocketSee tests/e2e-tests/README.md for what the end-to-end tests need.
