# eBird Dataset Data
eBird Dataset Data is a reusable Django app for loading data from the
[eBird Basic Dataset](https://science.ebird.org/en/use-ebird-data/download-ebird-data-products),
v1.14, into a database.
## 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](https://science.ebird.org/en/use-ebird-data/download-ebird-data-products) which is intended for for analysis and modelling.
This project contains a loader and models to take data from a download (CSV) file
and load it into a database. From there you can analyse the data with python,
jupyter notebooks, or build a web site.
To get started, you will need to [sign up](https://secure.birds.cornell.edu/identity/account/create) for an eBird account,
then [request access](https://ebird.org/data/download), which usually takes 7 days to be reviewed and approved.
## Install
You can use either [pip](https://pip.pypa.io/en/stable/) or [uv](https://docs.astral.sh/uv/)
to download the [package](https://pypi.org/project/ebird-dataset-data/) from PyPI and
install it into a virtualenv:
```shell
pip install ebird-dataset-data
```
or:
```shell
uv add ebird-dataset-data
```
Update `INSTALLED_APPS` in your Django setting:
```python
INSTALLED_APPS = [
...
ebird.dataset.data
]
```
Finally, run the migrations to create the tables:
```python
python manage.py migrate
```
## Demo
If you check out the code from the repository there is a fully functioning
Django site. It contains pages for checklists, observations and species,
where you can browse the records or search by location, observer. date. etc.
The Django Admin lets you browse and edit the records in the database.
```shell
git clone git@github.com:StuartMacKay/ebird-dataset-data.git
cd ebird-api-data
```
Create the virtual environment:
```shell
uv venv
```
Activate it:
```shell
source .venv/bin/activate
```
Install the requirements:
```shell
uv sync
```
Run the database migrations:
```shell
python manage.py migrate
```
Create a user:
```shell
python manage.py createsuperuser
```
Run the demo:
```shell
python manage.py runserver
```
Now, either visit the site, http:localhost:8000/, or log into the Django Admin,
http:localhost:8000/admin to browse the tables.
## Project Information
* Documentation: https://ebird-dataset-data.readthedocs.io/en/latest/
* Issues: https://todo.sr.ht/~smackay/ebird-dataset-data
* Repository: https://git.sr.ht/~smackay/ebird-dataset-data
* 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-data
The app is tested on Python 3.10+, and officially supports Django 4.2 LTS, 5.0, 5.1, and 5.2 LTS.
# License
eBird Dataset Data is released under the terms of the [MIT](https://opensource.org/licenses/MIT) license.
Raw data
{
"_id": null,
"home_page": null,
"name": "ebird-dataset-data",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12",
"maintainer_email": null,
"keywords": "Django, checklists, eBird, eBird Basic Dataset, models, observations, species",
"author": null,
"author_email": "Stuart MacKay <smackay@flagstonesoftware.com>",
"download_url": "https://files.pythonhosted.org/packages/28/80/ba514b5b85df160a1c280323a832bcbe5f3c8a283448627376d160174ea2/ebird_dataset_data-0.2.0.tar.gz",
"platform": null,
"description": "# eBird Dataset Data\n\neBird Dataset Data is a reusable Django app for loading data from the \n[eBird Basic Dataset](https://science.ebird.org/en/use-ebird-data/download-ebird-data-products),\nv1.14, into a database.\n\n## Overview\n\nThe Cornell Laboratory of Ornithology in Ithaca, New York runs the eBird database\nwhich collects observations of birds from all over the world, and publishes them\non (eBird.org)[https://ebird.org]. The data is also available via the \n[eBird Basic Dataset](https://science.ebird.org/en/use-ebird-data/download-ebird-data-products) which is intended for for analysis and modelling.\nThis project contains a loader and models to take data from a download (CSV) file \nand load it into a database. From there you can analyse the data with python, \njupyter notebooks, or build a web site.\n\nTo get started, you will need to [sign up](https://secure.birds.cornell.edu/identity/account/create) for an eBird account, \nthen [request access](https://ebird.org/data/download), which usually takes 7 days to be reviewed and approved.\n\n## Install\n\nYou can use either [pip](https://pip.pypa.io/en/stable/) or [uv](https://docs.astral.sh/uv/)\nto download the [package](https://pypi.org/project/ebird-dataset-data/) from PyPI and\ninstall it into a virtualenv:\n\n```shell\npip install ebird-dataset-data\n```\n\nor:\n\n```shell\nuv add ebird-dataset-data\n```\n\nUpdate `INSTALLED_APPS` in your Django setting:\n\n```python\nINSTALLED_APPS = [\n ...\n ebird.dataset.data\n]\n```\n\nFinally, run the migrations to create the tables:\n\n```python\npython manage.py migrate\n```\n\n## Demo\n\nIf you check out the code from the repository there is a fully functioning\nDjango site. It contains pages for checklists, observations and species,\nwhere you can browse the records or search by location, observer. date. etc. \nThe Django Admin lets you browse and edit the records in the database.\n\n```shell\ngit clone git@github.com:StuartMacKay/ebird-dataset-data.git\ncd ebird-api-data\n```\n\nCreate the virtual environment:\n```shell\nuv venv\n```\n\nActivate it:\n```shell\nsource .venv/bin/activate\n```\n\nInstall the requirements:\n```shell\nuv sync\n```\n\nRun the database migrations:\n```shell\npython manage.py migrate\n```\n\nCreate a user:\n```shell\npython manage.py createsuperuser\n```\n\nRun the demo:\n\n```shell\npython manage.py runserver\n```\n\nNow, either visit the site, http:localhost:8000/, or log into the Django Admin, \nhttp:localhost:8000/admin to browse the tables.\n\n## Project Information\n\n* Documentation: https://ebird-dataset-data.readthedocs.io/en/latest/\n* Issues: https://todo.sr.ht/~smackay/ebird-dataset-data\n* Repository: https://git.sr.ht/~smackay/ebird-dataset-data\n* Announcements: https://lists.sr.ht/~smackay/ebirders-announce\n* Discussions: https://lists.sr.ht/~smackay/ebirders-discuss\n* Development: https://lists.sr.ht/~smackay/ebirders-develop\n\nThe repository is also mirrored on Github:\n\n* Repository: https://github.com/StuartMacKay/ebird-dataset-data\n\nThe app is tested on Python 3.10+, and officially supports Django 4.2 LTS, 5.0, 5.1, and 5.2 LTS.\n\n# License\n\neBird Dataset Data is released under the terms of the [MIT](https://opensource.org/licenses/MIT) license.\n",
"bugtrack_url": null,
"license": null,
"summary": "eBird Dataset Data is a reusable Django app for loading data from the eBird Basic Dataset into a database.",
"version": "0.2.0",
"project_urls": null,
"split_keywords": [
"django",
" checklists",
" ebird",
" ebird basic dataset",
" models",
" observations",
" species"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "3b915e78c62e96bd28c1af4a5374eebd18b2b26d8a442fba2ebc355b14f4e33d",
"md5": "8110399b37d7a8251e52aea5bb02b443",
"sha256": "452f0cfb7fd9b3aa152fa20e9cb64422a6fe5b18713d42af2d04e7abb5a12e3c"
},
"downloads": -1,
"filename": "ebird_dataset_data-0.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8110399b37d7a8251e52aea5bb02b443",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 24524,
"upload_time": "2025-07-26T13:55:11",
"upload_time_iso_8601": "2025-07-26T13:55:11.822765Z",
"url": "https://files.pythonhosted.org/packages/3b/91/5e78c62e96bd28c1af4a5374eebd18b2b26d8a442fba2ebc355b14f4e33d/ebird_dataset_data-0.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "2880ba514b5b85df160a1c280323a832bcbe5f3c8a283448627376d160174ea2",
"md5": "a859cd1c54d9f6f92dfa0d1664dde427",
"sha256": "4e28af364925214ef554c9a9e1488135f69216123d348b1930e8b8624410b45c"
},
"downloads": -1,
"filename": "ebird_dataset_data-0.2.0.tar.gz",
"has_sig": false,
"md5_digest": "a859cd1c54d9f6f92dfa0d1664dde427",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 17074,
"upload_time": "2025-07-26T13:55:13",
"upload_time_iso_8601": "2025-07-26T13:55:13.041001Z",
"url": "https://files.pythonhosted.org/packages/28/80/ba514b5b85df160a1c280323a832bcbe5f3c8a283448627376d160174ea2/ebird_dataset_data-0.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-26 13:55:13",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "ebird-dataset-data"
}
JSON