{"id":28956931,"url":"https://github.com/developmentseed/pearl-backend","last_synced_at":"2025-06-23T21:41:14.132Z","repository":{"id":37762485,"uuid":"460777052","full_name":"developmentseed/pearl-backend","owner":"developmentseed","description":"PEARL (Planetary Computer Land Cover Mapping) Platform API and Infrastructure","archived":false,"fork":false,"pushed_at":"2024-03-19T20:06:31.000Z","size":17758,"stargazers_count":55,"open_issues_count":30,"forks_count":6,"subscribers_count":7,"default_branch":"develop","last_synced_at":"2024-06-11T18:39:20.311Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","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/developmentseed.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2022-02-18T08:51:57.000Z","updated_at":"2024-05-17T16:53:04.000Z","dependencies_parsed_at":"2024-02-26T15:53:33.286Z","dependency_job_id":null,"html_url":"https://github.com/developmentseed/pearl-backend","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/developmentseed/pearl-backend","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/developmentseed%2Fpearl-backend","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/developmentseed%2Fpearl-backend/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/developmentseed%2Fpearl-backend/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/developmentseed%2Fpearl-backend/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/developmentseed","download_url":"https://codeload.github.com/developmentseed/pearl-backend/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/developmentseed%2Fpearl-backend/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261561261,"owners_count":23177560,"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","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":[],"created_at":"2025-06-23T21:41:12.864Z","updated_at":"2025-06-23T21:41:14.100Z","avatar_url":"https://github.com/developmentseed.png","language":"JavaScript","readme":"\u003ch1 align=center\u003ePEARL API \u0026 Infrastructure\u003c/h1\u003e\n\n\u003cimg width=\"1161\" alt=\"image\" src=\"https://user-images.githubusercontent.com/371666/155303281-fafe417e-3e66-46c2-8a1d-20b9d25b89cd.png\"\u003e\n\nPEARL is a landcover mapping platform that uses human in the loop machine learning approach. This repository contains the API and infrastructure to run the platform. The frontend is maintained at [pearl-frontend](https://github.com/developmentseed/pearl-frontend/).\n\n## Overview\n\nPEARL infrastructure uses Kubernetes to manage resources and provide on-demand GPU support. The following is a high-level architecture. A websocket router manages available GPU/CPU and allocates them to clients.\n\n![pearl backend](https://user-images.githubusercontent.com/371666/154953888-3410f5de-7355-4d9f-ac8a-ca42f9879496.jpg)\n\nThis repository contains code for the `api`, `gpu`, `socket` and `tiles` services in the [`services`](services/) directory. Code to deploy all the services and infrastructure on Azure can be found in the [`deployment`](deployment/) directory. We have also included terraform resource definitions in [`deployment/terraform`](deployment/terraform) and a Helm chart in [`deployment/helm`](deployment/helm/). The Helm chart is published separately at https://devseed.com/pearl-helm-chart and instructions for using the helm chart can be found [here](deployment/helm/pearl-helm/README.md).\n\nThe machine learning components [are documented here](docs/ml.md).\n## Development\n\nInitial development can be bootstrapped by running all of the services via docker-compose\n\n```sh\ndocker-compose up --build -d\n```\n\nThis script will ensure that you have a postgres database set up, and will configure and\nstart all necessary services locally for a fully functional dev environment\n\n## API Documentation\n\nAPI documentation can be found by opening the following location in your browser `file://\u003cpath-to-git-repo\u003e/lulc-infra/api/doc/index.html`\n\nor ideally, once your development environment has been started, API documentation can be found\nby navigating to `http://localhost:2000/docs`.\n\n## Deployment and CI\n\nNotes on deploy process and CI integration can be found [here](docs/deploy.md).\n\nYou can also `helm` to deploy directly onto a Kubernetes cluster. Instructions can be found [here](deployment/helm/pearl-helm/).\n\nNote: This has currently been tested using AKS on Azure, but should ideally work on any Kubernetes cluster with minimal changes.\n\n## Debugging and Logs\n\nInstructions for accessing the Grafana UI to inspect application logs can be found [here](docs/logs.md)\n\n## LICENSE\n[MIT](/LICENSE.md)","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevelopmentseed%2Fpearl-backend","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevelopmentseed%2Fpearl-backend","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevelopmentseed%2Fpearl-backend/lists"}