https://github.com/balena-labs-projects/rosetta-at-home
https://github.com/balena-labs-projects/rosetta-at-home
aarch64 arm balena balenacloud rosetta-home x86-64
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/balena-labs-projects/rosetta-at-home
- Owner: balena-labs-projects
- Archived: true
- Created: 2020-04-01T14:33:14.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2022-10-24T21:41:06.000Z (over 2 years ago)
- Last Synced: 2024-11-08T20:45:29.518Z (6 months ago)
- Topics: aarch64, arm, balena, balenacloud, rosetta-home, x86-64
- Language: EJS
- Homepage:
- Size: 530 KB
- Stars: 80
- Watchers: 9
- Forks: 17
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# Fold for Covid - help in the fight against COVID-19 with Rosetta@home
With the recent COVID-19 outbreak, R@h has been used to predict the structure of proteins important to the disease as well as to produce new, stable mini-proteins to be used as potential therapeutics and diagnostics, like the one displayed above which is bound to part of the COVID-19 spike protein. [Read more](http://boinc.bakerlab.org/rosetta/)
This project has been built to get you up and running with as many devices as possible for the least effort. If you want to deploy and run this project manually, read on, if you want to add your devices to the global fleet, head on over to [foldforcovid.io](https://foldforcovid.io)
## Hardware compatibility
This app should run on 64-bit OS devices with 1 or more GB of RAM, but we've tested on the below:
* Raspberry Pi 3 (1GB RAM)
* Raspberry Pi 4 (1GB RAM)
* Raspberry Pi 4 (2GB RAM)
* Raspberry Pi 4 (4GB RAM)
* NVIDIA Jetson Nano
* Intel NUC (and other generic x86_64 devices)
* Most Intel-based laptops & desktops with a wired ethernet connection should also work OK
## Getting started
This is a containerized app intended to run on [balenaCloud](https://www.balena.io/cloud/), which allows you to deploy it to an entire fleet of devices and get as many of them folding as quickly as possible for the least effort. BalenaCloud covers 10 devices for free, but if you want to run this app on a larger fleet please [get in touch](mailto:[email protected]).
One-click deploy to balenaCloud:
[](https://dashboard.balena-cloud.com/deploy?repoUrl=https://github.com/balenalabs/rosetta-at-home)
**or**
### Setup the device(s)
* Sign up for or login to the [balenaCloud dashboard](https://dashboard.balena-cloud.com)
* Create a fleet, selecting the correct device type
* Add a device to the fleet, enabling you to download the OS
* Flash the downloaded OS to your SD card with [balenaEtcher](https://balena.io/etcher)
* Power up the Pi and check it's online in the dashboard
### Deploy this app
* Install the [balena CLI tools](https://github.com/balena-io/balena-cli/blob/master/INSTALL.md)
* Login with `balena login`
* Download this app and from the app directory run `balena push ` where `` is the name you gave your balenaCloud fleet in the first step.
* The app will then be downloaded and started by each device in your fleet.
For further information, see the [balenaCloud documentation](https://www.balena.io/docs/learn/getting-started/jetson-nano/nodejs/).
### Check the status
This app has a built in web interface that allows you to see statistics and more. Simply visit the local IP address of your device or [enable the public URL for your device](https://www.balena.io/docs/learn/manage/actions/#enable-public-device-url) in the balenaCloud dashboard and you'll be able to access statistics from anywhere!
The web interface uses [GoTTY](https://github.com/yudai/gotty) to provide access to `boinctui` via a standard web browser.
## Customization
By default, your device will contribute work units to the [Fold for Covid team](https://boinc.bakerlab.org/rosetta/team_display.php?teamid=18832). To override this and contribue to a team of your choosing, you can set your account authentication key by using the [device variable](https://www.balena.io/docs/learn/manage/serv-vars/) `ACCOUNT_KEY`, set from the balenaCloud dashboard. This will automatically update the XML configuration file with your key and ensure you're credited for completed work units.
## FAQ
* You can start the cli-based UI by running `boinctui` within a terminal to the `boinc-client` container.
* If you are not receiving work units, in `boinctui` try pressing F9 -> rosetta -> update.
## Contributing
We encourage you to submit bug reports, feature requests and PRs, compatibility updates, everything! Let's get this running on as many devices as we can.
## Support
If you have issues deploying or running this project please start a thread in the [balena forums](https://forums.balena.io) and we'll be happy to help.