Relm is an open source 3D spatial platform for the web. You can use it to meet, work, organize, collaborate, and hold online events.
We've been learning how to re-create a feeling of togetherness online. Flat screens and distance are the constraints within which we create a work of art. Relm has been built with a love for discovering details that help us feel comfortable, at ease, and natural as we gather with friends, family, and colleagues. We hope you'll feel the same way when you try it out.
If you use a service hosted by us or someone else, there is no setup required--it all works seamlessly in a browser.
As open source software (AGPL), you are also welcome to set it up on your own server, modify the code, and host the service for your community.
- Browser-based, works in Chrome, Firefox, Safari
- Multiplayer
- In-game audio/video conferencing
- Collaborative world editor
- Text chat
- Non-verbal communication: sitting, waving, etc.
- Avatar customization
- Permissions (read, access, edit)
- Auto-clone worlds if permitted (append "/new" to URL)
- ... many more
You're welcome to visit our Discord server here.
To run Relm locally, you will need the following prerequisites:
- nodejs (v14+ is recommended)
- postgresql (v13+ is recommended)
- python with distutils (for leveldown dep; e.g.,
python3 -m pip install setuptools
)
On Mac OS, these libraries may be required via homebrew:
brew install vips
brew install python-setuptools
Create an empty database called relm
:
createdb relm
Then, clone this repo, install the dependencies and run the server:
pnpm install
pnpm dev
This should start both the backend server (yjs, assets, permissions) and frontend server (hosting the client javascript files). Visit https://localhost:8080/admin?token=setup to initialize a blank world and authorize your admin token.
After your first-time use, the ?token=setup
is no longer required.
That's very generous of you! You might like to check out the high-level Architecture document as well as the Changelog. Please also join us on Discord if you'd like to chat, or start a discussion.
Once you're ready, there's a directory called contributors where we ask you to add a file indicating your willingness to grant the same license (AGPL) as we have.
Relm's source code is licensed under the GNU AGPL 3.0 license. We encourage you to use Relm for any purpose, including commercial, but with the understanding that changes to the source code must be made available to the public for the benefit of everyone.
(C) 2021-2023 Duane Johnson and other contributors