The code behind https://developmentseed.org/contributor-network.
This visual is derived from the excellent ORCA top-contributor-network by Nadieh Bremer.
To view the site on http://localhost:8000:
python -m http.server 8000Get 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 buildIf 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 fetchTo list all configured contributors by category:
uv run contributor-network list-contributorsTo find new repositories that DevSeed employees contribute to:
uv run contributor-network discover --min-contributors 2 --limit 50This queries GitHub to find repos where multiple DevSeed employees have contributed, which are not yet in the configuration.
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 8000npm test
uv run pytestuv run ruff check --fix
uv run ruff formatEdit 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)
This visualization uses the Development Seed brand colors:
- Grenadier (#CF3F02): Primary orange accent
- Aquamarine (#2E86AB): Secondary blue
- Base (#443F3F): Text color
This work was copied-and-modified from https://github.com/nbremer/ORCA and is licensed under the same (MPL).
