Package: openselery
Continuous and Transparent Developer PayoutOpenSelery is a decentralized framework for a free and transparent salary distribution in free software. It defines a funding distribution to generate a transparent and adaptable cash flow to your digital project and all its contributors, including your dependencies.Please keep in mind that OpenSelery is in an experimental state right now. The amount of funding should therefore be kept to a minimum.FeaturesTransparent payout to the developers of your Github project.Dependency scanning for most languages to even include developers of your dependency.Distribution of money is done via Bitcoin (currently via coinbase).Investors can see a transparent payout with public CI logs.How does OpenSelery work?OpenSelery is configured based on the selery.yml file, so it runs as a CI-job in GitHub.Gathers contributor information about the target project via the Github and Libraries.io APIFilters out contributors that not made the email address visible in the Github profile.Creates a uniform weight distribution between all contributors. Custom distributions like release participation are under construction.Creates an activity weight between all contributors to reward activity.Sums the weights.Randomly chooses contributors based on the weights.Pays out Bitcoin to the chosen contributor email addresses via the Coinbase API. Contributor without a Coinbase account will get a email to claim the donation.DemoContinuous IntegrationUse thegithub templateto integrate OpenSelery into your in your project with a single github action file.Command Line UsageCreate the access Tokens and AccountsYou will need API tokens forGithubandLibraries.io. Then you can simulate payouts without thecoinbase tokento try it out and find the right settings. You can later add the coinbase token. Configure theaccess control settingsof the automated coinbase account.Install withdocker:cd~
gitclonehttps://github.com/protontypes/openselery.gitcdopenselery
./build.shWhen you are done trying it out, create a dedicated coinbase account with limited amounts. OpenSelery is based on the APIs of Libraries.io, Github and Coinbase. Setting simulation to false (in your selery.yml) will require your coinbase tokens.Never transfer or store large values with automated cryptocurrency wallets. Use recurring automated transaction from another account to recharge you wallet on a regular base.Transfer some money to this wallet for testing. See theprice listfor transfering money into the coinbase account.Create a readonly token file for your user, where you store API keys and secrets:mkdir~/.openselery/
touch~/.openselery/tokens.env
chmod400~/.openselery/tokens.envAdd your API keys and secrets to the newly created file (~/.openselery/tokens.env).Never store these tokens in a repository.nanoCOINBASE_TOKEN=XXXXXXXXXXXXXXXXCOINBASE_SECRET=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXGITHUB_TOKEN=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXLIBRARIES_API_KEY=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXConfigure your distribution in theselery.ymlfile located in ~/.openselery/ or your <target_repository>
Thesimulationparamter is setTrueby default. You will need theCOINBASE_TOKENandCOINBASE_SECRETwhen setting Simulation to False in your selery.yml. You can use theselery.ymltemplate from the OpenSelery project, modifiy it and copy it into you <target_repository>.Clone OpenSelerygitclonehttps://github.com/protontypes/openselery.gitFund the target repositoryThis will send cryptocurrency to weighted random product contributors with a valid email address on the git platform (GitHub) or git commit:Run as dockerized Command-Line Toolenv$(cat~/.openselery/tokens.env)~/openselery/run.sh<target_repository>Run nativly on Debian / UbuntuInstall Dependenciessudoaptupdate&&aptinstallgitrubyruby-devruby-bundlerbuild-essentailcurlpython3-pipcdopenselery
bundleinstallpip3install-rrequirements.txtRun OpenSeleryTARGET_DIR=<target_repository>&&env$(cat~/.openselery/tokens.env)python3selery.py--config$TARGET_DIR/selery.yml--directory$TARGET_DIR--resultresultsContributionConstributors on the master branch will probably get emails with cryptocurrency. Only git profiles with emails on the Github profile page are considered.Knowledge BaseKnowledge-LinksArtwork by Miriam Winter