{"id":29832576,"url":"https://github.com/timothyrenner/bfro_sightings_data","last_synced_at":"2025-07-29T11:37:42.630Z","repository":{"id":22276236,"uuid":"95269360","full_name":"timothyrenner/bfro_sightings_data","owner":"timothyrenner","description":"Code for obtaining sightings data from the Bigfoot Field Researchers Organization (BFRO).","archived":false,"fork":false,"pushed_at":"2024-04-24T01:19:20.000Z","size":665,"stargazers_count":14,"open_issues_count":1,"forks_count":3,"subscribers_count":5,"default_branch":"main","last_synced_at":"2024-04-24T03:16:41.652Z","etag":null,"topics":["data","dataset","sasquatch"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/timothyrenner.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2017-06-24T01:59:48.000Z","updated_at":"2024-04-24T01:19:22.000Z","dependencies_parsed_at":"2022-09-10T22:30:49.581Z","dependency_job_id":"e412d44b-0b72-4a59-ad6e-bd1277cd1939","html_url":"https://github.com/timothyrenner/bfro_sightings_data","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/timothyrenner/bfro_sightings_data","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timothyrenner%2Fbfro_sightings_data","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timothyrenner%2Fbfro_sightings_data/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timothyrenner%2Fbfro_sightings_data/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timothyrenner%2Fbfro_sightings_data/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/timothyrenner","download_url":"https://codeload.github.com/timothyrenner/bfro_sightings_data/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timothyrenner%2Fbfro_sightings_data/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267678470,"owners_count":24126338,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-29T02:00:12.549Z","response_time":2574,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["data","dataset","sasquatch"],"created_at":"2025-07-29T11:36:44.110Z","updated_at":"2025-07-29T11:37:42.613Z","avatar_url":"https://github.com/timothyrenner.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BFRO Sightings Data\n\nThe Bigfoot Field Researchers Organization ([BFRO](http://www.bfro.net/)) is an organization dedicated to studying the bigfoot / sasquatch mystery.\nIt has collected data on thousands of sightings throughout North America, many of which are geocoded.\nThis project contains code for downloading and extracting geocoded results, as well as full text reports on all data available on their site.\n\n## A quick update\n\nThis repo has undergone some significant changes recently.\nThese changes all support automating what I used to do manually once a year.\nThey include refactoring a lot of the customized python code I wrote 7+ years ago.\nOver time I'll be adding more documentation, analysis examples, and maybe example apps with streamlit, datapane, or dash too.\nThis refactor is just the first step.\n\n## Setup \n\nTo get started, run the following commands to set up the environment.\n\n```shell\nconda env create -f environment.yaml\nconda activate bfro-sightings-data\nmake dev-env\n```\n\nThis creates a conda environment with all the dependencies.\n\nThe weather stuff is a tad problematic because it expects there to be a Visual Crossing API key.\nThey are free for up to a thousand calls a day (and we have more calls than that, so you'd need to stagger them to fully hydrate the cache).\nTo use it, add `VISUAL_CROSSING_KEY` to the environment or a local `.env` file.\n\nFor more information on the weather data, see the [Visual Crossing documentation](https://www.visualcrossing.com/resources/documentation/weather-api/timeline-weather-api/).\n\n## Full Pipeline\n\nThe pipeline (including scraper, weather, and the DBT project), is in the `pipeline/` directory.\nHowever, there's a shell script that will run it all for you.\n\n```sh\n# In project root.\n./run-pipeline-local.sh False\n```\n\nTo run a test run, use\n\n```sh\n./run-pipeline-local.sh True\n```\n\n## Deployment and Orchestration\n\nThere's a Dockerfile and docker make targets (set to push to a local registry).\nIf you want to run in a container you should wrap the `run-pipeline-local.sh` shell script into one that will pull down / push updated data before the container tears down, or execute with a bind mount or volume mount on the local project root.\n\n## Data Dictionary\n\nIs in DBT!\nIncluding the sources.\n\n`pipeline/bfro_mini_warehouse/models/sources/local_files.yml` for the local sources, and `pipeline/bfro_mini_warehouse/models/docs` for the others.\nYou can cd into the `pipeline/bfro_mini_warehouse` directory and build the docs the usual DBT way.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimothyrenner%2Fbfro_sightings_data","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftimothyrenner%2Fbfro_sightings_data","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimothyrenner%2Fbfro_sightings_data/lists"}