A picture speaks volumes, as do the words that frame it.

📌 If you find our project helpful and need more API token quotas, you can request additional tokens by filling out this form. Our team will review your request and allocate more tokens for your use in one or two days. You can also apply for more tokens by sending us an email.

Introduction Video 🎥

Turn on the music if possible 🎧

trex2_ongithub.mp4

News 📰

2024-06-24: We have introduced two new free products based on T-Rex2:
- Count Anything APP: CountAnything is a versatile, efficient, and cost-effective counting tool that utilizes advanced computer vision algorithms, specifically T-Rex, for automated counting. It is applicable across various industries, including manufacturing, agriculture, and aquaculture.

countingapp.mp4

T-Rex Label: T-Rex Label is an advanced annotation tool powerd by T-Rex2, specifically designed to handle the complexities of various industries and scenarios. It is the ideal choice for those aiming to streamline their workflows and effortlessly create high-quality datasets.

trex_label.mp4

2024-05-17: Grounding DINO 1.5 is released. This is IDEA Research's Most Capable Open-World Object Detection Model Series. It can detect any object throught text prompts!

Contents 📜

Introduction Video 🎥
News 📰
Contents 📜
1. Introduction 📚
- What Can T-Rex Do 📝
2. Try Demo 🎮
3. API Usage Examples📚
4. Local Gradio Demo with API🎨
5. Related Works
BibTeX 📚

1. Introduction 📚

Object detection, the ability to locate and identify objects within an image, is a cornerstone of computer vision, pivotal to applications ranging from autonomous driving to content moderation. A notable limitation of traditional object detection models is their closed-set nature. These models are trained on a predetermined set of categories, confining their ability to recognize only those specific categories. The training process itself is arduous, demanding expert knowledge, extensive datasets, and intricate model tuning to achieve desirable accuracy. Moreover, the introduction of a novel object category, exacerbates these challenges, necessitating the entire process to be repeated.

T-Rex2 addresses these limitations by integrating both text and visual prompts in one model, thereby harnessing the strengths of both modalities. The synergy of text and visual prompts equips T-Rex2 with robust zero-shot capabilities, making it a versatile tool in the ever-changing landscape of object detection.

What Can T-Rex Do 📝

T-Rex2 is well-suited for a variety of real-world applications, including but not limited to: agriculture, industry, livstock and wild animals monitoring, biology, medicine, OCR, retail, electronics, transportation, logistics, and more. T-Rex2 mainly supports three major workflows including interactive visual prompt workflow, generic visual prompt workflow and text prompt workflow. It can cover most of the application scenarios that require object detection

workflows.mp4

2. Try Demo 🎮

We are now opening online demo for T-Rex2. Check our demo here

3. API Usage Examples📚

We are now opening free API access to T-Rex2. For educators, students, and researchers, we offer an API with extensive usage times to support your educational and research endeavors. You can get API at here request API.

Full API documentation can be found here.

Setup

Install the API package and acquire the API token from the email.

git clone https://github.com/IDEA-Research/T-Rex.git
cd T-Rex
pip install dds-cloudapi-sdk==0.1.1
pip install -v -e .

Interactive Visual Prompt API

In interactive visual prompt workflow, users can provide visual prompts in boxes or points format on a given image to specify the object to be detected.
```
python demo_examples/interactive_inference.py --token <your_token> 
```
- You are supposed get the following visualization results at demo_vis/

Generic Visual Prompt API

In generic visual prompt workflow, users can provide visual prompts on one reference image and detect on the other image.
```
python demo_examples/generic_inference.py --token <your_token> 
```
- You are supposed get the following visualization results at demo_vis/
  + =

Customize Visual Prompt Embedding API

In this workflow, you cam customize a visual embedding for a object category using multiple images. With this embedding, you can detect on any images.

python demo_examples/customize_embedding.py --token <your_token>

You are supposed to get a download link for this visual prompt embedding in safetensors format. Save it and let's use it for embedding_inference.

Embedding Inference API

With the visual prompt embeddings generated from the previous API. You can use it detect on any images.

  python demo_examples/embedding_inference.py --token <your_token>

4. Local Gradio Demo with API🎨

4.1. Setup

Install T-Rex2 API if you haven't done so

- install gradio and other dependencies
```bash
# install gradio and other dependencies
pip install gradio==4.22.0
pip install gradio-image-prompter

4.2. Run the Gradio Demo

python gradio_demo.py --trex2_api_token <your_token>

4.3. Basic Operations

Draw Box: Draw a box on the image to specify the object to be detected. Drag the left mouse button to draw a box.
Draw Point: Draw a point on the image to specify the object to be detected. Click the left mouse button to draw a point.
Interactive Visual Prompt: Provide visual prompts in boxes or points format on a given image to specify the object to be detected. The Input Target Image and Interactive Visual Prompt Image should be the same
Generic Visual Prompt: Provide visual prompts on multiple reference images and detect on the other image.

5. Related Works

🔥 We release the training and inference code and demo link of DINOv, which can handle in-context visual prompts for open-set and referring detection & segmentation. Check it out!

BibTeX 📚

@misc{jiang2024trex2,
      title={T-Rex2: Towards Generic Object Detection via Text-Visual Prompt Synergy}, 
      author={Qing Jiang and Feng Li and Zhaoyang Zeng and Tianhe Ren and Shilong Liu and Lei Zhang},
      year={2024},
      eprint={2403.14610},
      archivePrefix={arXiv},
      primaryClass={cs.CV}
}

abdshomad/T-Rex