Open Source Observer is a free analytics suite that helps funders measure the impact of open source software contributions to the health of their ecosystem.
/apps: The OSO apps/docs: documentation (Docusaurus)- on Cloudflare - Production build
/frontend: frontend application (Next.js)- on Vercel - Production build
/hasura-clickhouse: API service (Hasura+Clickhouse) - Production/hasura-trino: API service (Hasura+Trino) - Production
/docker: Docker files/lib: Common libraries/oss-artifact-validators: Simple library to validate different properties of an "artifact"/utils- Common TypeScript utilities used in the monorepo
/ops: Our ops related code/external-prs: GitHub app for validating pull requests/help-charts: Helm charts for Kubernetes/k8s-*: Kubernetes configuration/kind: Local Kind configuration/opsscripts: Python module of various ops related tools/tf-modules: Terraform modules
/warehouse: All code specific to the data warehouse/dbt: dbt configuration/docker: Docker configuration/metrics_tools: Python utilities for managing data/oso_dagster: Dagster configuration for orchestrating software-defined assets/oso_sqlmesh: sqlmesh configuration/pyoso: Python package forpyoso- Also contains other tools to manage warehouse pipelines
Before you begin you'll need the following on your system:
- Node >= 20 (we suggest installing with nvm)
- pnpm >= 9 (see here)
- Python >=3.11 (see here)
- Python uv >= 0.6 (see here)
- git (see here)
To install Node.js dependencies
pnpm install
Also install the python dependencies
uv sync --all-packages
For setup and common operations for each subproject, navigate into the respective directory and check out the README.md.
You can also find some operations guides on our documentation.
The code and documentation in this repository is released under Apache 2.0 (see LICENSE).
This repository does not contain data. Datasets may include material that may be subject to third party rights. For details on each dataset, see the Data Overview.