Repository files navigation

Website ·Docs ·Discord ·Twitter ·YouTube ·Issues

Algora connectscompanies anddevelopers for full-time and contract work.

This codebase consists of the following:

• aweb app to publish & manage SWE jobs, contracts & bounties
• aGitHub app to create bounties & reward tips on issues and PRs
• apayment processor to handle payouts, compliance & 1099s

OSS communities and closed source teams canself-host or joinAlgora.io to accomplish the following:

Algora.io, hosted by Algora Public Benefit Corporation, extends functionalities including:

• developers' top OSS contributions are automatically displayed on their Algora profiles
• companies' job applicants are automatically screened & ranked for OSS contributions
• companies and developers are automatically matched for full-time & contract work based on tech/budget/location preferences

Algora.io is a complete solution for sourcing, screening, interviewing & onboarding engineers to your team.

• Profile Embed
  • Embeddable profile for GitHub and personal websites
  • One-click bounty and contract sharing
• Apply Embed
  • One-click apply embed for careers pages
• New payment/payout options
  • Alipay, Wise, crypto etc.
• Localization of platform & matches
• New workflow integrations
  • GitLab, Linear, Plane, Cursor etc.
• New clients
  • Mobile, desktop, CLI
• Crowdfunding enhancements

The easiest way to get up and running is toinstall and use Docker for running Postgres.

Make sure Docker, Elixir, Erlang and Node.js are all installed on your development machine. You can install Elixir and Erlang/OTP withASDF from the project root as follows:

1. Install ASDF
2. asdf plugin add erlang
3. asdf plugin add elixir
4. asdf plugin add pnpm
5. asdf plugin add nodejs
6. asdf install

We also recommend usingdirenv to load environment variables andentr to watch for file changes.

1. Clone the repo and go to the project folder

   git clone git@github.com:algora-io/algora.git&&cd algora

2. Initialize and load.env

   cp .env.example .env&& direnv allow .env

3. Start a container with latest postgres

   make postgres

4. Install and setup dependencies

   make install

5. Start the web server inside IEx

   make server

6. (Optional) Watch for file changes and auto reload IEx shell in a separate terminal

   make watch

Some features of Algora rely on external services. If you're not planning on using these features, feel free to skip setting them up.

Register new GitHub app and set

• Homepage URL:http://localhost:4000
• Callback URL:http://localhost:4000/callbacks/github/oauth
• Setup URL:http://localhost:4000/callbacks/github/installation
• Redirect on update: Yes
• Webhook URL: https://[your-public-proxy]/webhooks/github (e.g. ngrok, Cloudflare Tunnel)
• Secret: [generate new random string]
• Permissions:
  • Read & write issues
  • Read & write pull requests
  • Read account email address
• Events: issues, pull requests, issue comment, pull request review, pull request review comment

Once you have obtained your client ID and secret, add them to your.env file and rundirenv allow .env.

GITHUB_CLIENT_ID=""GITHUB_CLIENT_SECRET=""GITHUB_APP_HANDLE=""GITHUB_APP_ID=""GITHUB_WEBHOOK_SECRET=""GITHUB_PRIVATE_KEY=""

Create new Stripe account to obtain your secrets and add them to your.env file.

STRIPE_PUBLISHABLE_KEY=""STRIPE_SECRET_KEY=""STRIPE_WEBHOOK_SECRET=""

To host static assets, set up a public bucket on your preferred S3-compatible storage service and add the following credentials to your.env file:

AWS_ENDPOINT_URL_S3=""AWS_REGION=""AWS_ACCESS_KEY_ID=""AWS_SECRET_ACCESS_KEY=""BUCKET_NAME=""

To receive webhooks from GitHub or Stripe on your local machine, you'll need a way to expose your local server to the internet. The easiest way is to use a service likeCloudflare Tunnel orngrok.

If you'd like to utilize our Cloudflare TunnelGenServer to automatically run a tunnel when you start the app, you'll need to set up a named tunnel on your own domain:

cloudflared tunnel logincloudflared tunnel createlocalcloudflared tunnel route dnslocal http://local.yourdomain.com

And then add it to your.env file:

CLOUDFLARE_TUNNEL="local"

If you're using another service, make sure to start the tunnel manually in another terminal.