{"id":13808885,"url":"https://github.com/codingCoffee/fahclient","last_synced_at":"2025-05-14T03:31:46.688Z","repository":{"id":51792651,"uuid":"249564327","full_name":"codingCoffee/fahclient","owner":"codingCoffee","description":"Dockerized Folding@home client with NVIDIA GPU support to help battle COVID-19","archived":false,"fork":false,"pushed_at":"2022-09-25T12:40:05.000Z","size":1164,"stargazers_count":38,"open_issues_count":2,"forks_count":8,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-08-04T01:10:07.188Z","etag":null,"topics":["2019-ncov","coronavirus","covid-19","distributed-computing","docker","folding","folding-at-home","foldingathome","nvidia","nvidia-container-toolkit","nvidia-cuda","nvidia-docker"],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/codingCoffee.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":["codingcoffee"],"custom":["https://www.paypal.me/codingcoffee"]}},"created_at":"2020-03-23T23:10:28.000Z","updated_at":"2021-01-15T15:00:45.000Z","dependencies_parsed_at":"2023-01-18T21:46:04.007Z","dependency_job_id":null,"html_url":"https://github.com/codingCoffee/fahclient","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codingCoffee%2Ffahclient","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codingCoffee%2Ffahclient/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codingCoffee%2Ffahclient/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codingCoffee%2Ffahclient/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codingCoffee","download_url":"https://codeload.github.com/codingCoffee/fahclient/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225273287,"owners_count":17448080,"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":["2019-ncov","coronavirus","covid-19","distributed-computing","docker","folding","folding-at-home","foldingathome","nvidia","nvidia-container-toolkit","nvidia-cuda","nvidia-docker"],"created_at":"2024-08-04T01:01:54.227Z","updated_at":"2024-11-19T00:31:11.345Z","avatar_url":"https://github.com/codingCoffee.png","language":"Dockerfile","readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"./.assets/images//docker-fahclient.png\" width=\"250\"\u003e\n  \u003ch1\u003e\n    Dockerized FAHClient\n  \u003c/h1\u003e\n\u003c/div\u003e\n\n---\n\n[![License](https://img.shields.io/github/license/codingcoffee/fahclient)](https://github.com/codingcoffee/fahclient/blob/master/LICENSE)\n[![Docker Pulls](https://img.shields.io/docker/pulls/codingcoffee/fahclient)](https://hub.docker.com/r/codingcoffee/fahclient)\n[![Docker Image Size (tag)](https://img.shields.io/docker/image-size/codingcoffee/fahclient?sort=date)](https://hub.docker.com/r/codingcoffee/fahclient/tags?name=latest)\n[![Docker Image CI](https://github.com/codingCoffee/fahclient/workflows/Docker%20Image%20CI/badge.svg)](https://github.com/codingCoffee/fahclient/actions?query=workflow%3A%22Docker+Image+CI%22)\n\n[Folding@home (FAH or F@h)](https://foldingathome.org) is a distributed computing project for simulating protein dynamics, including the process of protein folding and the movements of proteins implicated in a variety of diseases. It brings together citizen scientists who volunteer to run simulations of protein dynamics on their personal computers. Insights from this data are helping scientists to better understand biology, and providing new opportunities for developing therapeutics.\n\n## Usage\n\n- CPU only\n\n```sh\ndocker run -it --rm -d \\\n  --name fahclient \\\n  -p 7396:7396 \\\n  codingcoffee/fahclient \\\n  --allow 0/0  \\\n  --web-allow 0/0\n```\n\n- CPU and GPU\n\n```sh\ndocker run -it --rm -d \\\n  --name fahclient \\\n  --gpus all \\\n  -p 7396:7396 \\\n  -e ENABLE_GPU=true \\\n  codingcoffee/fahclient \\\n  --allow 0/0  \\\n  --web-allow 0/0\n```\n\nYou can also visit the web dashboard by visiting http://localhost:7396 in your browser.\n\n\u003cimg src=\"./.assets/images/fahclient_web_dashboard.png\" width=\"750\"\u003e\n\n## GPU Support\n\nSince this image uses [nvidia/cuda](https://hub.docker.com/r/nvidia/cuda) as it's base image, to use the GPU support, you'll need to have an NVIDIA GPU, and [NVIDIA Container Toolkit](https://github.com/NVIDIA/nvidia-docker) installed on your system.\n\n## List of usable environment variables\n\n| Environment Varible | Value                   | Default     |\n| ------------------- | ----------------------- | ----------- |\n| `USER`              | your username           | `Anonumous` |\n| `TEAM`              | your team name          | `0`         |\n| `PASSKEY`           | your passkey            |             |\n| `ENABLE_GPU`        | `true`/`false`          | `false`     |\n| `ENABLE_SMP`        | `true`/`false`          | `true`      |\n| `POWER`             | `full`/`medium`/`light` | `full`      |\n\n## FAQ\n\nQ: How can I use this with Docker Compose?\n\nA: Well, you can use it with docker compose if you don't want the GPU support. This is because docker compose still doesn't have the a way to specify the `--gpu` flag, or atleast I wasn't able to figure it out. If you did, open a issue / send a PR with the `docker-compose.yml` file.\n\n## Logs\n\nTo get the logs of the running container\n\n```sh\ndocker logs -f fahclient\n```\n\n## Build\n\nTo build the image locally\n\n```sh\ndocker build -t codingcoffee/fahclient .\n```\n\n## Contribution\n\nHave better suggestions to optimize the image? Found some typos? Go ahead and send in a Pull Request! Contributions of any kind welcome!\n\n## LICENSE\n\nThe code in this repository has been released under the [GNU General Public License v3](https://github.com/codingcoffee/fahclient/blob/master/LICENSE)\n\n","funding_links":["https://github.com/sponsors/codingcoffee","https://www.paypal.me/codingcoffee"],"categories":["Dockerfile"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FcodingCoffee%2Ffahclient","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FcodingCoffee%2Ffahclient","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FcodingCoffee%2Ffahclient/lists"}