grantmakers / grantmakers.github.io

Grantmakers.io is a free, open source project built to help nonprofits utilize the incredible IRS electronic 990-PF dataset.
https://www.grantmakers.io
MIT License
49 stars 13 forks source link
algolia-search irs-form990-data jekyll-website nonprofit

Grantmakers.io - A Community Project

The Grantmakers.io project is spread across two repos:

  1. Foundation Search (this repo)
  2. Foundation Profiles

Goal

Demonstrate how open source technologies + hosted microservices can be leveraged to minimize the cost of hosting and sharing philanthropic data.

Grantmakers.io was built at zero cost and has zero ongoing costs.

Search

The search functionality is fully hosted by Algolia. See /assets/js/search-profiles.js.

Data

All data is pulled directly from machine-readable IRS Form 990PF. These files are hosted publicly by Amazon Web Services and controlled by the IRS.

To build your own database of tax filings direct from the AWS source dataset, I've open sourced the Node + MongoDB scripts used to build Grantmakers.io. If you prefer other platforms (e.g. Python), check out the Nonprofit Open Data Collective or a quick search on Github should yield a few results.

Researchers

If you're struggling with the AWS filings, get in touch. I have MongoDB-friendly BSON files I'm happy to share with the academic, research, and journalism communities. Unzipped, these files are ~10GB in size and contain the AWS index data, filing data, and normalized data. Of course, you'll need to be a little familiar with MongoDB to use the files (see below).

Setting up MongoDB using BSON files

First, set up your MongoDB instance. You have two options:

  1. Install MongoDB on your local machine. MacOS instructions here.
  2. Use a hosted cloud service. Check out MongoDB Atlas (students and faculty might be eligible for free credits).

Next, import the BSON file using the mongorestore command:
mongorestore --gzip --db=yourdbname path/to/BSON/files/

Feature Requests

If you have a question, feature request, find a bug, or just want to say hi, please open an issue on GitHub.

Roadmap

Grantmakers.io is developed in the open and uses Github Issues at its core. To view the prioritized list across all repos, simply download the Zenhub browser extension.

Tools

Cross-browser compatibility provided by BrowserStack
browserstack

Credits

License

Copyright 2016 Chad Kruse

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.