https://github.com/opensource-observer/oso
Open source AI-driven data platform
https://github.com/opensource-observer/oso
ai data-platform data-visualization impact-analysis open-source public-goods
Last synced: 17 days ago
JSON representation
Open source AI-driven data platform
- Host: GitHub
- URL: https://github.com/opensource-observer/oso
- Owner: opensource-observer
- License: apache-2.0
- Created: 2023-07-25T20:41:57.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-10-07T23:23:27.000Z (19 days ago)
- Last Synced: 2025-10-08T01:19:18.576Z (19 days ago)
- Topics: ai, data-platform, data-visualization, impact-analysis, open-source, public-goods
- Language: Python
- Homepage: https://www.opensource.observer
- Size: 123 MB
- Stars: 105
- Watchers: 6
- Forks: 35
- Open Issues: 545
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
# oso [![License: Apache 2.0][license-badge]][license] [![Github Actions][gha-badge]][gha] [](https://deepwiki.com/opensource-observer/oso)
[license]: https://opensource.org/license/apache-2-0/
[license-badge]: https://img.shields.io/badge/License-Apache2.0-blue.svg
[gha]: https://github.com/opensource-observer/oso/actions/workflows/ci-default.yml
[gha-badge]: https://github.com/opensource-observer/oso/actions/workflows/ci-default.yml/badge.svg
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.
[opensource.observer](https://www.opensource.observer)
## Organization
- `/apps`: The OSO apps
- `/docs`: documentation (Docusaurus)
- [on Cloudflare](https://docs.opensource.observer/) - Production build
- `/frontend`: frontend application (Next.js)
- [on Vercel](https://www.opensource.observer) - 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
- `/docker`: Docker configuration
- `/metrics_tools`: Python utilities for managing data
- `/oso_agent`: OSO agent
- `/oso_dagster`: Dagster configuration for orchestrating software-defined assets
- `/oso_sqlmesh`: sqlmesh configuration
- `/pyoso`: Python package for `pyoso`
- Also contains other tools to manage warehouse pipelines
## Quickstart
### System Prerequisites
Before you begin you'll need the following on your system:
- Node >= 20 (we suggest installing with [nvm](https://github.com/nvm-sh/nvm))
- pnpm >= 9 (see [here](https://pnpm.io/installation))
- Python >=3.11 (see [here](https://www.python.org/downloads/))
- Python uv >= 0.6 (see [here](https://pypi.org/project/uv/))
- git (see [here](https://github.com/git-guides/install-git))
### Setup dependencies
To install Node.js dependencies
```
pnpm install
```
Also install the python dependencies
```
uv sync --all-packages
```
## Reference Playbooks
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](https://docs.opensource.observer/docs/guides/ops/).
## License
The code and documentation in this repository
is released under Apache 2.0
(see [LICENSE](./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](https://docs.opensource.observer/docs/integrate/datasets/).