ebird-dataset-explorer

A Django-based web site for browsing the eBIrd Basic Dataset

https://github.com/ebirders/ebird-dataset-explorer

Science Score: 44.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (12.4%) to scientific vocabulary

Keywords

django ebird ebird-basic-dataset website

Scientific Fields

Engineering Computer Science - 40% confidence
Last synced: 6 months ago · JSON representation ·

Repository

A Django-based web site for browsing the eBIrd Basic Dataset

Basic Info
  • Host: GitHub
  • Owner: ebirders
  • License: mit
  • Language: Python
  • Default Branch: master
  • Homepage:
  • Size: 1.11 MB
Statistics
  • Stars: 0
  • Watchers: 1
  • Forks: 0
  • Open Issues: 0
  • Releases: 0
Topics
django ebird ebird-basic-dataset website
Created over 1 year ago · Last pushed 7 months ago
Metadata Files
Readme Changelog License Citation

README.md

eBird Dataset Explorer

eBird Dataset Explorer is a Django-based web site for browsing observations from the eBird Basic Dataset v1.16.

Overview

The Cornell Laboratory of Ornithology in Ithaca, New York runs the eBird database which collects observations of birds from all over the world, and publishes them on (eBird.org)[https://ebird.org]. The data is also available via the eBird Basic Dataset which is intended for for analysis and modelling.

This project contains Django-based web site for browsing observations from the eBird Basic Data. This project uses the ebird-dataset-data which allows you to load the CSV based files published by eBird and load them into a database.

Getting Started

To get started, you will need to sign up for an eBird account, then request access, which usually takes 7 days to be reviewed and approved.

Next, get a copy of the repository:

shell git clone https://git.sr.ht/~smackay/ebird-dataset-explorer cd ebird-dataset-explorer

Create the virtual environment:

shell uv venv

Activate it:

shell source .venv/bin/activate

Install the requirements:

shell uv sync

Create a copy of the .env.example file and set the URL to access the database:

cp .env.example .env

For example:

shell DATABASE_URL=postgres://dataset:passwordd@localhost:5432/dataset

The site is developed and tested with PostgreSQL.

Run the database migrations:

python manage.py migrate

Create an admin user:

python manage.py createsuperuser

There is a copy of the sample file from the eBird Basic Dataset in the /data/datasets/ directory. Use the load_dataset management command to load it into the database:

shell python manage.py load_dataset data/datasets/ebd.csv

It's time to start the server:

python manage.py runserver

Finally, visit the home page to view the observations:

http://localhost:8000/

Project Information

  • Issues: https://todo.sr.ht/~smackay/ebird-dataset-explorer
  • Repository: https://git.sr.ht/~smackay/ebird-dataset-explorer
  • Announcements: https://lists.sr.ht/~smackay/ebirders-announce
  • Discussions: https://lists.sr.ht/~smackay/ebirders-discuss
  • Development: https://lists.sr.ht/~smackay/ebirders-develop

The repository is also mirrored on Github:

  • Repository: https://github.com/StuartMacKay/ebird-dataset-explorer

License

eBird Dataset Browser is released under the terms of the MIT license.

Owner

  • Name: eBirders
  • Login: ebirders
  • Kind: organization

Python libraries, Jupyer Notebooks and Django apps and sites for working with data from eBird.org

Citation (CITATION.cff)

abstract: A web site / workbench for analysing observations from the eBird Basic Dataset.
authors:
  - name: Stuart MacKay
cff-version: 1.2.0
date-released: 2025-07-17
keywords:
  - eBird
  - eBird Basic Dataset
  - Django
  - observations
  - checklists
  - species
license: MIT License
message: If you use this software, please cite it using the metadata from this file.
repository-code: "https://github.com/StuartMacKay/ebird-dataset-explorer"
title: eBird Reports
version: 0.0.0

GitHub Events

Total
Last Year

Dependencies

pyproject.toml pypi
  • django >=5.1.3
  • django-environ >=0.11.2
  • gunicorn >=23.0.0
  • python-json-logger >=2.0.7
  • sentry-sdk >=2.18.0
  • whitenoise [brotli]>=6.8.2
uv.lock pypi
  • annotated-types 0.7.0
  • anyio 4.9.0
  • asgiref 3.9.1
  • asttokens 3.0.0
  • bracex 2.6
  • brotli 1.1.0
  • bump-my-version 1.2.0
  • certifi 2025.7.14
  • cfgv 3.4.0
  • click 8.2.1
  • colorama 0.4.6
  • decorator 5.2.1
  • distlib 0.3.9
  • django 5.2.4
  • django-autocomplete-light 3.12.1
  • django-ckeditor 6.7.3
  • django-debug-toolbar 5.2.0
  • django-environ 0.12.0
  • django-extensions 4.1
  • django-js-asset 3.1.2
  • django-spaceless-templates 1.0.2
  • ebird-codes 0.0.2
  • ebird-dataset-data 0.2.0
  • ebird-dataset-explorer 2025.7.15
  • executing 2.2.0
  • filelock 3.18.0
  • gunicorn 23.0.0
  • h11 0.16.0
  • httpcore 1.0.9
  • httpx 0.28.1
  • identify 2.6.12
  • idna 3.10
  • iniconfig 2.1.0
  • ipython 9.4.0
  • ipython-pygments-lexers 1.1.1
  • jedi 0.19.2
  • markdown-it-py 3.0.0
  • matplotlib-inline 0.1.7
  • mdurl 0.1.2
  • nodeenv 1.9.1
  • packaging 25.0
  • parso 0.8.4
  • pexpect 4.9.0
  • platformdirs 4.3.8
  • pluggy 1.6.0
  • polib 1.2.0
  • pre-commit 4.2.0
  • prompt-toolkit 3.0.51
  • psycopg2-binary 2.9.10
  • ptyprocess 0.7.0
  • pure-eval 0.2.3
  • pydantic 2.11.7
  • pydantic-core 2.33.2
  • pydantic-settings 2.10.1
  • pygments 2.19.2
  • pymemcache 4.0.0
  • pytest 8.4.1
  • pytest-django 4.11.1
  • python-dotenv 1.1.1
  • pyyaml 6.0.2
  • questionary 2.1.0
  • rich 14.0.0
  • rich-click 1.8.9
  • ruff 0.12.3
  • sentry-sdk 2.33.0
  • sniffio 1.3.1
  • sqlparse 0.5.3
  • stack-data 0.6.3
  • tomlkit 0.13.3
  • traitlets 5.14.3
  • typing-extensions 4.14.1
  • typing-inspection 0.4.1
  • tzdata 2025.2
  • urllib3 2.5.0
  • virtualenv 20.31.2
  • wcmatch 10.1
  • wcwidth 0.2.13
  • whitenoise 6.9.0