Gegevens verzamelen van Garmin, Apple Health en Whoop op één plek zonder hoofdpijn

Stel je dit voor: je hebt besloten om een fitness tracker of biohacking app te bouwen. En dan begint het "leuke" deel. Om je dienst te integreren met Garmin, moet je door zeven cirkels van de hel met hun API. Voor Apple Health moet je native code schrijven voor iOS. Voor Google Health Connect — voor Android. Uiteindelijk besteed je in plaats van het bouwen van coole functies, zes maanden aan het regelen van OAuth-autorisaties, verschillende JSON-formaten en het omrekenen van mijlen naar kilometers.

Het Open Wearables project probeert dit probleem radicaal op te lossen. Het team bouwt een open-source platform dat al het rommelige integratiewerk met wearables afhandelt. Je krijgt één enkele uniforme API, terwijl alle vendor-complexiteit onder de motorkap blijft.

Waarom Dit Wanneer Er Kant-en-Klare SDK's Zijn

Meestal kiezen ontwikkelaars tussen twee paden: integraties zelf bouwen of betalen aan cloud-aggregators zoals Terra of Rook. De eerste optie is traag en duur om te onderhouden. De tweede betekent afhankelijkheid van een externe dienst en maandelijkse kosten per gebruiker.

Open Wearables biedt een derde pad: een zelfgehoste oplossing. Je deployt het platform op je eigen server, gegevens blijven bij jou, en je betaalt geen kosten. Bovendien normaliseert het project de gegevens niet alleen — het standaardiseert ze naar één uniform formaat. Het maakt niet uit of hartslaggegevens van Suunto-horloges of een Oura-ring komen — in je backend ziet het er identiek uit.

Wat het Platform Nu Kan Doen

Het project is in een vroeg stadium, maar de basisstructuur is al behoorlijk functioneel. Hier is wat je nu kunt proberen:

• Uniform developer dashboard. Na het opstarten via Docker krijg je een admin paneel waar je gebruikers kunt beheren, API-sleutels kunt genereren en de status van gegevenssynchronisatie kunt monitoren.
• Kant-en-klare autorisatiestromen. Het platform regelt de OAuth-dans met Garmin, Polar en Suunto. Je genereert simpelweg een link voor de gebruiker, ze loggen in met hun provider, en gegevens stromen je database binnen.
• Mobile SDK's. Voor degenen die met gegevens direct op de telefoon werken, zijn er native bibliotheken voor iOS (Swift), Android (Kotlin) en zelfs een Flutter wrapper. Dit is cruciaal voor Apple Health, waarvan de gegevens niet simpelweg via een cloud-aanvraag kunnen worden opgehaald.
• Achtergrondsynchronisatie. Dit wordt afgehandeld door FastAPI en Celery. Het systeem pollt automatisch providers en werkt activiteits- en trainingsstatistieken bij.

Technische Stack en Architectuur

De ontwikkelaars hebben het wiel niet opnieuw uitgevonden en hebben het project gebouwd op bewezen tools. De backend is geschreven in FastAPI — de standaard voor moderne Python-diensten, snel en met uitstekende Swagger auto-documentatie (beschikbaar direct na opstarten).

PostgreSQL wordt gebruikt voor gegevensopslag, en Redis voor taakwachtrijen en caching. De frontend van het admin paneel is gebouwd met React met TanStack Router. Een interessant punt: de auteurs benadrukken dat het platform is ontworpen als single-tenant. Dit betekent dat één instantie één organisatie bedient. Geen extra complexiteit met toegangsrechten tussen verschillende bedrijven binnen één database.

AI-Functies: Toekomstplannen

Het interessantste op de roadmap is Health Insights. De ontwikkelaars plannen een automatiseringslaag toe te voegen gebaseerd op natuurlijke taal. Het idee is dat je een conditie in tekst kunt schrijven: "Als de rusthartslag van een gebruiker met 20% is gestegen over drie dagen, stuur een webhook." Het systeem zal dit zelf interpreteren en de trigger instellen.

Ze beloven ook een AI Health Assistant — een chat-widget die je in je app kunt embedden. De gebruiker zal kunnen vragen: "Hoe heb ik deze week geslapen vergeleken met vorige week?", en de AI zal de verzamelde gegevens uit de Open Wearables database analyseren.

Hoe te Starten en Testen

Als je Docker hebt geïnstalleerd, kun je het project letterlijk in een paar minuten opzetten. De instructies zijn eenvoudig:

1. Clone de repository:

   git clone https://github.com/the-momentum/open-wearables.git
   cd open-wearables
   

2. Kopieer de voorbeeldconfiguraties:

   cp ./backend/config/.env.example ./backend/config/.env
   cp ./frontend/.env.example ./frontend/.env
   

3. Start het op:

   docker compose up -d
   

Daarna opent de portal op poort 3000, en de API op 8000. Om het zoeken naar echte apparaten voor testen te voorkomen, kun je de opdracht make seed uitvoeren, die de database vult met neppe gebruikers en workouts.

Wie Zou Dit Project Moeten Bekijken

Open Wearables is een gewondige vondst voor Health & Fitness startups. Als je een corporate wellness portaal, een coaching app of een onderzoeksproject bouwt dat gegevens van verschillende apparaten moet verzamelen, zal dit je honderden ontwikkeluren besparen.

Natuurlijk is het project nog jong (pre-1.0 versie), en de API kan veranderen. Maar open source code en de mogelijkheid tot zelfhosting wegen hier tegen op. Als je gevoelige medische gegevens van gebruikers niet wilt overdragen aan externe proprietaire diensten, is dit waarschijnlijk het beste dat er momenteel beschikbaar is in open source voor zulke taken.

Trouwens, het team heeft een actieve Discord community waar je direct kunt chatten met maintainers. Als je besluit het te implementeren — neem een kijkje, ze reageren vrij snel.