Skip to content

An experimental visualization of contributions at Development Seed to repositories both within and outside of our organization

License

Notifications You must be signed in to change notification settings

developmentseed/contributor-network

Repository files navigation

Development Seed Contributor Network

The code behind https://developmentseed.org/contributor-network.

This visual is derived from the excellent ORCA top-contributor-network by Nadieh Bremer.

Usage

To view the site on http://localhost:8000:

python -m http.server 8000

Development

Get uv and a GitHub personal access token with public_repo scope (e.g. via gh auth token if you have the Github CLI).

If you've only made changes to the javascript, you can rebuild the site with:

uv run contributor-network build

If you've changed the config and need to re-fetch data from the Github API, run this (warning, this takes a while):

export GITHUB_TOKEN="your_token_here"
uv run contributor-network fetch

To list all configured contributors by category:

uv run contributor-network list-contributors

To find new repositories that DevSeed employees contribute to:

uv run contributor-network discover --min-contributors 2 --limit 50

This queries GitHub to find repos where multiple DevSeed employees have contributed, which are not yet in the configuration.

Full workflow

To update the visualization with new data:

# 1. Set your GitHub token
export GITHUB_TOKEN="your_token_here"

# 2. (Optional) Discover new repos to add
uv run contributor-network discover --min-contributors 2

# 3. Edit config.toml to add/remove repos or contributors

# 4. Fetch data from GitHub
uv run contributor-network fetch

# 5. Build the site
uv run contributor-network build

# 7. Preview locally
cd dist && python -m http.server 8000

Tests

npm test
uv run pytest

Lints

uv run ruff check --fix
uv run ruff format

Configuration

Edit config.toml to configure:

  • repositories: List of GitHub repos to track (format: "owner/repo")
  • contributors.devseed: Current DevSeed employees (format: github_username = "Display Name")
  • contributors.alumni: Friends and alumni (commented out by default)

Branding

This visualization uses the Development Seed brand colors:

  • Grenadier (#CF3F02): Primary orange accent
  • Aquamarine (#2E86AB): Secondary blue
  • Base (#443F3F): Text color

License

This work was copied-and-modified from https://github.com/nbremer/ORCA and is licensed under the same (MPL).

About

An experimental visualization of contributions at Development Seed to repositories both within and outside of our organization

Resources

License

Stars

Watchers

Forks

Contributors 7