An open-source citizen science platform for global bioacoustic monitoring. We're building a "Shazam for nature" to help listen to the planet.
View Demo
·
Report Bug
·
Request Feature
Project Soundscape is a mission-driven initiative to create a live, global sound-map of our planet's health. Using a simple mobile app, anyone can record 15 seconds of audio, which our AI models then analyze to identify everything from a rare bird song to the noise of urban traffic.
Our goal is to empower researchers, conservationists, and communities with the data they need to:
- Track Biodiversity: Monitor animal populations and detect endangered species in real-time.
- Study Noise Pollution: Understand the impact of human activity on our environments.
- Promote Environmental Awareness: Connect people with the sounds of the world around them.
We believe that by listening to the world, we can better understand and protect it.
This project is built with a modern, scalable, and open-source stack. We leverage a microservices architecture to keep our components modular and maintainable.
| Client (Mobile) | Backend (BaaS) | AI Service (Python) |
|---|---|---|
 |
  |
  |
| Flutter | Node.js & Appwrite | Python, FastAPI & TensorFlow |
| Cross-platform app for iOS & Android. | Manages users, data, and business logic. | Serves our powerful AI models. |
This organization hosts all the official source code for Project Soundscape.
- soundscape-app: The main Flutter application for iOS and Android. This is what our users interact with.
- soundscape-api-server: The Python and FastAPI server that hosts our AI models (Perch v2 and YAMNet) on Hugging Face Spaces.
- soundscape-backend: Contains the Appwrite backend functions (Node.js) that act as the bridge between the app and the AI service.
- soundscape-website: A simple, static website to showcase the project and the live sound-map.
We are excited to have you contribute! The best way to get started is to pick a repository and follow the setup instructions in its local README.md file.
A general workflow looks like this:
- Fork the repository you want to work on.
- Clone your forked repository to your local machine.
- Install the necessary dependencies (flutter pub get, npm install, pip install -r requirements.txt).
- Create a new branch for your feature or bug fix.
- Submit a pull request!
Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
Please read our CONTRIBUTING.md guide for details on our code of conduct and the process for submitting pull requests.
Distributed under the MIT License. See LICENSE for more information.
Project Link: https://github.com/project-soundscape