fit-tool
A library for reading and writing Garmin FIT files.
Decision gist · record as of 2026-08-14
Yes. Low install friction, no dependencies, active maintenance, permissive license, and no known vulnerabilities make it a safe choice. The explicit capability boundary documentation and multiple validation levels show mature design. Suitable for production use in fitness data pipelines, though real-world validation against Garmin devices should be verified for your specific workflow.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Low friction: pure Python with no runtime dependencies.
- Active maintenance with a release 9 days ago.
- Community-maintained fork after original author removal.
License · maintenance · safety
BSD-3-Clause (permissive) — BSD-3-Clause permissive license allows commercial and private use with minimal restrictions.
last release 2026-08-05 (9 days) · last repo commit 2026-08-14 · 5 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 145,463 downloads/mo, #11,125 on PyPI
Alternatives
Verify before relying
pip install fit-tool
from fit_tool import FitFile
fit = FitFile.from_file("activity.fit")
fit.to_csv("activity.csv")- Extent of Activity/Workout/Course workflow support beyond basic read/write
- Real-world validation accuracy against Garmin devices and official tools
- Performance characteristics for large or complex FIT files
What it is and what it does
fit-tool is a Python library for reading, writing, and validating Garmin FIT files—the binary format used by Garmin devices to store fitness activities, workouts, and courses. It provides both a high-level API (FitFile for loading and serializing, FitFileBuilder for construction) and a CLI for quick conversions to CSV. The library includes composable validation at multiple conformance levels and supports both PRESERVE and CANONICAL encoding modes.
The package is a community-maintained fork after the original was removed from PyPI. It bundles FIT Profile version 21.212.0 and supports Python 3.9 through 3.14. Runtime has no third-party dependencies, making installation and deployment straightforward. The documentation explicitly defines capability boundaries and validation levels, so you know what is and isn't supported before relying on it.
Use it for
- Convert Garmin activity files to CSV for analysis or import into other systems
- Stream large FIT files with bounded memory for processing without loading entire file
- Build and export custom Activity or Workout FIT files programmatically
- Validate FIT file integrity and conformance to Garmin specifications
- Parse GPS and fitness metrics from Garmin device exports for data pipeline integration
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
Low install friction, no dependencies, active maintenance, permissive license, and no known vulnerabilities make it a safe choice. The explicit capability boundary documentation and multiple validation levels show mature design. Suitable for production use in fitness data pipelines, though real-world validation against Garmin devices should be verified for your specific workflow.
Install
fit-tool on PyPI
Before you install
Low friction: pure Python with no runtime dependencies. Active maintenance with a release 9 days ago. Community-maintained fork after original author removal.
License in practice
BSD-3-Clause permissive license allows commercial and private use with minimal restrictions.
Quickstart
pip install fit-tool
from fit_tool import FitFile
fit = FitFile.from_file("activity.fit")
fit.to_csv("activity.csv")Verify before relying
- Extent of Activity/Workout/Course workflow support beyond basic read/write
- Real-world validation accuracy against Garmin devices and official tools
- Performance characteristics for large or complex FIT files
Package facts
| License | BSD-3-Clause permissive |
| Python support | Supports the current Python release >=3.9 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Actively maintained 9 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 145,463 / month, #11,125 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaIntended Audience :: DevelopersProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: 3.9 |
Evidence: fit_tool-0.9.16-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 › “read write fit files”
- fit-toolReads and writes Garmin FIT files for Activity, Workout, and Course…
- laspyLaspy reads, modifies, and writes LAS and LAZ LiDAR point cloud…
- fitdecodeParses and decodes FIT files (Garmin's ANT+ fitness data format) into…
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 fitparse · gpxpy · garmin-fit-sdk · fitdecode · garminconnect · ha-garmin · stravalib · garth · pynmeagps · cycler