BashOps Radar

Stop contributing to the wrong repositories.

BashOps Radar helps developers identify GitHub repositories where a well-chosen contribution has the highest chance of leading to founder conversations, paid sprint work, or long-term contracts.

Instead of guessing where to contribute, BashOps Radar helps you choose opportunities with intention.

Website: https://bashops.site

The Problem

Thousands of developers contribute to open source every day.

Most choose repositories randomly.

Many spend days on pull requests that never receive attention.

BashOps Radar helps answer one question before you write code:

Is this repository worth my time?

The Workflow

Choose Repository
-> Analyze Opportunity
-> Find Best First Issue
-> Submit Proof-of-Work
-> Start Founder Conversation
-> Paid Sprint
-> Retainer

What It Does

BashOps Radar analyzes a GitHub repository and returns:

• Opportunity score from 0-100
• Best issue to start with
• Merge and contract potential signals
• Proof-of-work angle
• Founder outreach direction
• Pipeline tracking from repository analysis to paid sprint

Free: analyze repositories you already know.

Pro: discover repositories worth contributing to before anyone else.

The goal is not to guarantee paid work. The goal is to help developers spend time on better repositories, build trust through useful contributions, and create stronger context for paid follow-up.

Works Everywhere

• Website
• Public API
• GitHub Action

Future surfaces:

• CLI
• MCP
• VS Code extension
• Browser extension

Product Surfaces

Website

Use the hosted web app to analyze repositories, manage a pipeline, and discover Pro opportunities:

https://bashops.site

Public API

Analyze a repository from scripts, tools, or workflows:

POST https://bashops.site/api/v1/analyze
Content-Type: application/json

{
  "repo_url": "https://github.com/sourcebot-dev/sourcebot"
}

GitHub Action

Use BashOps Radar inside GitHub Actions:

name: BashOps Radar

on:
  workflow_dispatch:

jobs:
  analyze:
    runs-on: ubuntu-latest
    steps:
      - id: radar
        uses: BashOpsDev/bashops-radar/github-action@main
        with:
          repo_url: https://github.com/sourcebot-dev/sourcebot

      - name: Show BashOps outputs
        run: |
          echo "Opportunity Score: ${{ steps.radar.outputs.opportunity_score }}"
          echo "Contract Potential: ${{ steps.radar.outputs.contract_potential }}"
          echo "Recommended Next Action: ${{ steps.radar.outputs.recommended_next_action }}"

Action documentation: github-action/README.md

Core Features

• GitHub repository analysis
• Lightweight opportunity scoring
• Issue ranking
• Pro Opportunity Finder
• User-scoped dashboard and pipeline
• Opportunity summary
• Pro-gated founder outreach generation
• Public API
• GitHub Action
• Paddle billing
• Resend transactional email
• Admin analytics

Tech Stack

• FastAPI
• Python
• Jinja2
• SQLAlchemy
• PostgreSQL
• Alembic
• Paddle
• Resend
• Gemini
• GitHub API
• Railway

Local Setup

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
cp .env.example .env

Generate a secure SECRET_KEY:

openssl rand -hex 32

Required environment variables:

SECRET_KEY=
DATABASE_URL=
GITHUB_TOKEN=
GEMINI_API_KEY=
PADDLE_API_KEY=
PADDLE_CLIENT_TOKEN=
PADDLE_PRICE_ID=
PADDLE_WEBHOOK_SECRET=
PADDLE_ENV=production
RESEND_API_KEY=
EMAIL_FROM=
EMAIL_FROM_NAME=BashOps Radar
SITE_URL=https://bashops.site
ADMIN_EMAILS=

The app will not start without SECRET_KEY and DATABASE_URL. PostgreSQL is the source of truth for accounts, analyses, pipeline status, and analytics.

Database

Schema is managed with Alembic:

alembic upgrade head

When changing models:

alembic revision --autogenerate -m "describe the change"
alembic upgrade head

Always review autogenerated migrations before running them in production.

Run Locally

uvicorn app:app --reload

Then open:

http://127.0.0.1:8000

Tests

pip install -r requirements-dev.txt
pytest tests/ -v

Tests run against a disposable SQLite database created in a temporary directory. They do not touch the production DATABASE_URL.

Deployment Notes

BashOps Radar is designed to run on Railway with PostgreSQL.

Typical deploy steps:

alembic upgrade head

Then start the app with:

uvicorn app:app --host 0.0.0.0 --port $PORT

Use Railway environment variables for all secrets. Do not commit .env.

GitHub Repository Metadata

Suggested public repository description:

Turn GitHub contributions into paid developer opportunities with proof-of-work intelligence.

Suggested GitHub topics:

fastapi
github
github-actions
developer-tools
ai
opensource
python
saas

License

MIT License. See LICENSE.