garmin-fit-sdk
Garmin FIT Python SDK
Decision gist · record as of 2026-08-14
Yes, with a license caveat. The package is actively maintained, has low install friction, supports current Python versions, and is the official Garmin decoder—essential if you work with FIT files. However, verify the license terms at the repository first, as the package metadata does not declare one; this is a blocker for proprietary or GPL-sensitive projects.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.6 or greater; input must be a valid FIT binary file (Garmin format).
- Low friction: pure Python wheel with only typing_extensions as a runtime dependency.
- Actively maintained—released 3 days ago with recent commits and 156 repository stars.
License · maintenance · safety
(unclear) — License status is unclear—no SPDX identifier or raw license text is available in the package metadata. Verify the actual license terms at the repository before use in proprietary or copyleft-sensitive contexts.
last release 2026-08-11 (3 days) · last repo commit 2026-08-13 · 156 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 139,291 downloads/mo, #11,302 on PyPI
Alternatives
Verify before relying
from garmin_fit_sdk import Decoder, Stream
stream = Stream.from_file("Activity.fit")
decoder = Decoder(stream)
messages, errors = decoder.read()
print(messages)- Whether the package is distributed under an open-source or proprietary license (license metadata is absent).
- Performance characteristics when decoding large FIT files or disabling CRC checks.
- Compatibility with all Garmin device types and FIT Profile versions.
What it is and what it does
The Garmin FIT Python SDK is an official decoder for Garmin's FIT (Flexible and Interoperable Data Transfer) binary format, commonly used to store activity data from Garmin sports watches, fitness trackers, and other devices. It reads binary FIT files and converts them into structured Python dictionaries and lists, with optional post-processing to apply scaling factors, convert timestamps to Python datetime objects, expand subfields, and validate file integrity via CRC checks.
The package provides a Stream abstraction to load FIT data from files, bytearrays, or BytesIO objects, and a Decoder class that validates the file structure, checks integrity, and reads messages with customizable options. Developers can disable expensive operations like CRC validation or type conversion to optimize performance, or use a callback listener to inspect and modify messages during decoding. It is typed and actively maintained by Garmin, with support for modern Python versions.
Use it for
- Extract and analyze activity records (GPS, heart rate, cadence) from Garmin device exports for fitness tracking applications.
- Validate FIT file integrity and structure before processing in data pipelines or archival systems.
- Convert raw FIT epoch timestamps and scaled sensor values into human-readable formats for reporting or visualization.
- Batch decode multiple FIT files while selectively disabling CRC checks or type conversion to reduce processing time.
- Inspect FIT file headers and metadata to determine device type or activity category before full decoding.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, with a license caveat.
The package is actively maintained, has low install friction, supports current Python versions, and is the official Garmin decoder—essential if you work with FIT files. However, verify the license terms at the repository first, as the package metadata does not declare one; this is a blocker for proprietary or GPL-sensitive projects.
Install
garmin-fit-sdk on PyPI
Before you install
Low friction: pure Python wheel with only typing_extensions as a runtime dependency. Actively maintained—released 3 days ago with recent commits and 156 repository stars. Supports current Python versions (3.6 and later).
Requires Python 3.6 or greater; input must be a valid FIT binary file (Garmin format).
License in practice
License status is unclear—no SPDX identifier or raw license text is available in the package metadata. Verify the actual license terms at the repository before use in proprietary or copyleft-sensitive contexts.
Quickstart
from garmin_fit_sdk import Decoder, Stream
stream = Stream.from_file("Activity.fit")
decoder = Decoder(stream)
messages, errors = decoder.read()
print(messages)Verify before relying
- Whether the package is distributed under an open-source or proprietary license (license metadata is absent).
- Performance characteristics when decoding large FIT files or disabling CRC checks.
- Compatibility with all Garmin device types and FIT Profile versions.
Package facts
| License | Not declared unclear |
| Python support | Supports the current Python release >=3.6 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagetyping_extensions |
| Maintenance | Actively maintained 3 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 139,291 / month, #11,302 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableNatural Language :: EnglishOperating System :: OS IndependentProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.6Programming Language :: Python :: 3.9Typing :: Typed |
Evidence: garmin_fit_sdk-21.213.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “garmin fit file decoder”
- garmin-fit-sdkDecodes Garmin FIT (Flexible and Interoperable Data Transfer) binary…
- fitdecodeParses and decodes FIT files (Garmin's ANT+ fitness data format) into…
- fit-toolReads and writes Garmin FIT files for Activity, Workout, and Course…
Give your agent the search over MCP, or paste the wish link into any chat.
More Utilities packages
Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.
Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.
Detects and normalizes text encoding from unknown or ambiguous sources, supporting all IANA character sets that Python's core library provides codecs for, with the ability to register custom codecs.
Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.
Pluggy provides a plugin system that lets you define hook specifications and register implementations to be called in sequence, enabling extensible Python applications without tight coupling.
Install it if you're building an extensible application or framework.
Pygments is a syntax highlighter that colorizes source code and text in over 500 languages and formats, outputting to HTML, LaTeX, RTF, SVG, images, or ANSI terminal sequences.
Install it if you need to display or transform source code.
Six provides utility functions to write Python code that runs on both Python 2.7 and Python 3.3+, smoothing over language differences between the two versions.
See also fitdecode · fit-tool · fitparse · ha-garmin · garminconnect · garth · pyubx2 · pytile · pyrtcm · cobs