Kompy - A Python Wrapper for Komoot APIs

If you are someone that enjoy the outdoor, you probably have heard of Komoot. Komoot is a route planning and navigation app that helps you to discover the great outdoors. It is a great tool to plan your next hike, bike ride or even a multi-day tour.

If you are like me, probably you have tough about using the data you generate on komoot to create your own dashboard or to do some analysis. Unfortunately, Komoot does not provide a Python package to access your data.

This is why I created Kompy.

What is Kompy?

Kompy is a Python wrapper for Komoot APIs. It is an easy-to-use Python package that allows you to access your data on Komoot by giving you a straightforward way to download and upload your activities from and to Komoot your Komoot dashboard.

How to install Kompy?

Kompy’s installation process is a breeze:

1. Ensure Python 3.11 or newer is installed on your system.
2. Simply run pip in your terminal:

pip install kompy

3. Import Kompy into your project: import kompy as kp.

What can you do with Kompy?

Kompy’s basic usage involves a few simple steps:

1. First, create a KomootConnector:

from kompy import KomootConnector
connector = KomootConnector(password=..., email=...)

2. Fetch your activities:

tours_list = connector.get_tours(user_identifier=None)

3. For detailed examples, visit this notebook.

Conclusion

Whether you’re a developer looking to explore the potential of fitness APIs or a fitness enthusiast with a knack for programming, Kompy opens up a world of possibilities. It’s user-friendly, efficient, and a great way to integrate your physical activities with your digital world.