Skip to content

Repository files navigation

Soundscape

Distributed, collaborative bioacoustic base for territories.

Inhabitants and microphone-equipped devices contribute local listening. AI interprets environmental and natural acoustics. The same shared index powers:

  • a colored health map (green = good quality · red / gray = critical or no data)
  • a simple recordings list (own point and/or public points)
  • a lean HTTP API for other apps (e.g. dashboards like World Monitor)

Status: early open-source scaffold. Specs and product shaping live in Sky-Forge session soundscape.

Monorepo

Path Role
apps/api Lean REST API (/v1/health-map, /v1/points, …)
apps/web Map UI + recordings list
packages/core Shared types (health index, acoustic points)
openapi/ OpenAPI 3 contract for API consumers

Quick start

pnpm install
pnpm --filter @soundscape/api dev    # http://localhost:8787
pnpm --filter @soundscape/web dev    # http://localhost:5173

API health: GET http://localhost:8787/v1/health

MVP scope

  • Collective index fed by distributed nodes
  • Colored map as visual render of that index
  • Installable contribution path (phone / mic device — app layer TBD)
  • Simple recordings list
  • Lean API: read health/map + list points

License

MIT

Contributing

See CONTRIBUTING.md.

About

Distributed collaborative bioacoustic base — health map, recordings, lean API

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages