aiotractive

What it is and what it does

aiotractive is an unofficial async Python wrapper around Tractive's REST API for pet tracking devices. It provides programmatic access to tracker status, historical positions, device control (buzzer, LED, live tracking), and real-time event streaming. The package is built on aiohttp for async I/O and includes full type hints for static analysis.

The library is in active development but not feature-complete relative to the Tractive web app. It requires an active Tractive subscription and valid credentials. Since it reverse-engineers Tractive's undocumented API, breaking changes may occur if Tractive modifies their endpoints. The project has low install friction and no known security vulnerabilities.

Use it for:

• Build home automation integrations that fetch pet location and battery status from Tractive trackers
• Stream real-time tracker events to a monitoring dashboard or alerting system
• Retrieve historical position data for pet movement analysis or reporting
• Programmatically control tracker features like buzzer and LED from custom applications
• Develop bot or script that periodically checks tracker status and notifies on location changes

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Asynchronous Python client for the Tractive pet tracking REST API, enabling programmatic access to tracker status, location history, device control, and real-time events.

Yes, if you own Tractive devices and need async Python access to their API. The package has low install friction, active maintenance, permissive licensing, and no known vulnerabilities. Be aware it is reverse-engineered (not official), in alpha status, and may break if Tractive changes their API. Not suitable if you need guaranteed API stability or comprehensive feature coverage.

Install

aiotractive on PyPI

pip install aiotractive

uv add aiotractive

poetry add aiotractive

Installing aiotractive

Before you install

Low install friction with pure Python dependencies (aiohttp, orjson, yarl). Active maintenance with recent commits and no known vulnerabilities. Supports Python 3.9 through 3.14.

License in practice

MIT license permits commercial and private use with minimal restrictions; you may use, modify, and distribute the package freely provided you include the original license notice.

Quickstart

pip install aiotractive

import asyncio
from aiotractive import Tractive

async def main():
    async with Tractive("email", "password") as client:
        trackers = await client.trackers()
        for tracker in trackers:
            pos = await tracker.pos_report()
            print(pos)

asyncio.run(main())

Requires an active Tractive subscription and valid account credentials. Tractive may change their API at any time, potentially breaking this reverse-engineered client.

Verify before relying

• Completeness of API coverage relative to the Tractive web app's full feature set
• Stability guarantees or SLA for the reverse-engineered API endpoints
• Whether all tracker models and device types are supported

Package facts

Evidence: aiotractive-1.0.3-py3-none-any.whl

Keywords: tractive, rest, api, aio, async, await

Tags

More WWW/HTTP packages