Skip to content

docs(readme): say "object tracking in Python" in the README - #587

Open
AlexBodner wants to merge 1 commit into
developfrom
docs/readme-object-tracking-python
Open

docs(readme): say "object tracking in Python" in the README#587
AlexBodner wants to merge 1 commit into
developfrom
docs/readme-object-tracking-python

Conversation

@AlexBodner

@AlexBodner AlexBodner commented Aug 26, 2026

Copy link
Copy Markdown
Collaborator

Problem

We do not rank for "object tracking python". A 12-star repo abandoned since 2023, ayush-thakur02/object-tracking-opencv, currently sits second for that query with our 3,717-star maintained library nowhere in sight.

The difference is that it says the words and we do not:

that repo roboflow/trackers
name object-tracking-opencv trackers
description "Object Tracking and Detection using OpenCV in python" "...leading multi-object tracking algorithms..."
topics object-tracking, opencv, object-detection, yolov4 no object-tracking, no python, no computer-vision

In our README, "object tracking" appears twice, "in Python" not at all, and the first mention of Python is buried in "Requires Python >= 3.10" at the end of the intro paragraph.

Google titles a repo page as GitHub - roboflow/trackers: <description> and draws the snippet from the README, so neither surface currently carries the phrase.

Fix

Two edits, +10 words total.

The tagline keeps its length and picks up the phrase:

-<p>Plug-and-play multi-object tracking for any detection model.</p>
+<p>Plug-and-play object tracking in Python, for any detection model.</p>

The intro now opens with a plain definitional sentence before the algorithm list:

-`trackers` gives you clean-room, benchmarked implementations of SORT, ByteTrack, ...
+`trackers` is an object tracking library for Python. It gives you clean-room, benchmarked implementations of SORT, ByteTrack, ...

That first line does double duty: a reader gets "what is this" in one sentence, and it is the passage search engines and LLM answers tend to quote, which currently has to be inferred from a list of algorithm names.

Next steps

I do not have the permissions to change these, but I strongly suggest we also:

  • Add the topics object-tracking, python, computer-vision, kalman-filter and re-identification. We have none of the first three, and they are the highest-volume terms in this space.

  • Update the description, which is what Google renders as the page title (GitHub - roboflow/trackers: <description>):

    Object tracking in Python. Clean-room implementations of SORT, ByteTrack, OC-SORT, BoT-SORT, C-BIoU and McByte. Apache 2.0, works with any detector.
    

Both live in the repo's About panel rather than the git tree, so neither can go in a PR. Both are a two-minute change and I expect either to matter more than this PR does.

Validation

  • mdformat --check --number --wrap=no README.md passes.
  • No claims changed, no links touched, no benchmark numbers involved.

🤖 Generated with Claude Code

The README never states what the library is in the terms people search for.
"object tracking" appears twice, "in Python" not at all, and the first
mention of Python is buried in "Requires Python >= 3.10" at the end of the
intro paragraph. Google titles the repo page from the GitHub description and
draws its snippet from the README, so neither currently carries the phrase.

Two edits. The tagline becomes "Plug-and-play object tracking in Python, for
any detection model", same length, and the intro now opens with a plain
definitional sentence: "trackers is an object tracking library for Python."
That first line is also the passage search engines and LLM answers quote,
and it gives a reader the "what is this" in one line before the algorithm
list.

Net +10 words. No claims changed, no links touched.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@AlexBodner
AlexBodner requested a review from SkalskiP as a code owner August 26, 2026 15:26
@Borda
Borda requested a lite review from Copilot August 31, 2026 12:33

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the repository’s README intro copy to explicitly include the phrase “object tracking in Python,” improving search/snippet relevance for “object tracking python” queries.

Changes:

  • Updates the top tagline to include “object tracking in Python”.
  • Adds a new first sentence to the intro paragraph describing trackers as an object tracking library for Python.
Suppressed comments (1)

README.md:10

  • The new lead sentence describes the project generically as “an object tracking library for Python”, while the rest of the README (and the library’s positioning) is specifically about multi-object tracking (MOT). Suggest calling that out in the first sentence while keeping the exact “object tracking … for Python” phrasing.
`trackers` is an object tracking library for Python. It gives you clean-room, benchmarked implementations of SORT, ByteTrack, OC-SORT, BoT-SORT, C-BIoU, and McByte — so occlusions, fast motion, and moving cameras stop being your problem to solve from scratch. It speaks `supervision.Detections` natively, slotting into any detector you already use — YOLO, DETR, RT-DETR, or anything else — without glue code. One consistent interface, whether you're a researcher comparing algorithms, an engineer shipping a production pipeline, or a hobbyist building something cool. Requires Python ≥ 3.10.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread README.md
<img width="200" src="https://raw.githubusercontent.com/roboflow/trackers/refs/heads/release/stable/docs/assets/logo-trackers-violet.svg" alt="trackers logo">
<h1>trackers</h1>
<p>Plug-and-play multi-object tracking for any detection model.</p>
<p>Plug-and-play object tracking in Python, for any detection model.</p>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants