CollectOSS is a software suite for collecting structured data about free and open-source software (FOSS) communities via git forges.
CollectOSS's main focus is to measure the overall health and sustainability of open source projects, as these types of projects are system critical for nearly every software organization or company.
The data CollectOSS collects covers more than just code contributions and extends to anything that can be derived from forge data, including comments, change reviews, releases, and other project activity or interactions. This data is stored in a relational database (PostgreSQL), enabling large-scale data aggregation across any number of repositories to provide context about the way these communities evolve.
CollectOSS is part of CHAOSS, which is a Linux Foundation® project. Many of our metrics are implementations of the metrics defined by the CHAOSS community.
CollectOSS is a Python project distributed via container images and aims to support all currently-supported versions of Python on macOS and Linux platforms. Docker is the primary supported container runtime, but Podman is also supported and used by some maintainers, although it requires configuring some extra permissions to run correctly.
Our main branch is our development branch that all pull requests should be based on. The release branch is where we merge and tag new versions and is the branch we recommend using in production. You can see tagged versions and corresponding release notes on the releases page.
Basic initial setup can be completed in a few minutes as follows:
- Clone the repository -
git clone https://github.com/chaoss/collectoss - (optional) if you want to build the development version, run
docker compose build - Copy the
environment.txtfile to a new file called.envand fill in values for the required variables - Run
docker compose upto start the containers
Check out the CollectOSS Documentation for more detailed setup instructions and troubleshooting steps.
We strongly believe that communities are what makes open source so impactful. We invite you to join our community, regardless of your experience level or coding abilities!
Check out the CHAOSS Getting Started guide to join Slack and learn more about CHAOSS. After you arrive, we recommend:
- Joining the #wg-collectoss-8knot channel (or ask for help finding it)
- Subscribing to the CHAOSS Software meetings in your calendar using the links on the CHAOSS Calendar page
Information about contribution guidelines, building from source, and testing can be found in our CONTRIBUTING.md.
CollectOSS metrics are used by many other visualization and metrics projects, such as:
If you would like your project or organization listed here, please file a Pull Request!
CollectOSS is free software: you can redistribute it and/or modify it under the terms of the MIT License as published by the Open Source Initiative. See the LICENSE file for more details.
Refer to CREDITS.md for detailed information about the people and funding that have helped make this project possible.