Instructions to use GroundingPI/GroundAnything with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

Libraries

How to use GroundingPI/GroundAnything with Transformers:

# Use a pipeline as a high-level helper
from transformers import pipeline

pipe = pipeline("image-text-to-text", model="GroundingPI/GroundAnything", trust_remote_code=True)
messages = [
    {
        "role": "user",
        "content": [
            {"type": "image", "url": "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/p-blog/candy.JPG"},
            {"type": "text", "text": "What animal is on the candy?"}
        ]
    },
]
pipe(text=messages)

# pip install -U transformers accelerate
# Load model directly
from transformers import AutoModelForCausalLM
model = AutoModelForCausalLM.from_pretrained("GroundingPI/GroundAnything", trust_remote_code=True, device_map="auto")

Notebooks
Google Colab
Kaggle
Local Apps Settings

vLLM

How to use GroundingPI/GroundAnything with vLLM:

Install from pip and serve model

# Install vLLM from pip:
pip install vllm
# Start the vLLM server:
vllm serve "GroundingPI/GroundAnything"
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:8000/v1/chat/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "GroundingPI/GroundAnything",
		"messages": [
			{
				"role": "user",
				"content": [
					{
						"type": "text",
						"text": "Describe this image in one sentence."
					},
					{
						"type": "image_url",
						"image_url": {
							"url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg"
						}
					}
				]
			}
		]
	}'

Use Docker

docker model run hf.co/GroundingPI/GroundAnything

SGLang

How to use GroundingPI/GroundAnything with SGLang:

Install from pip and serve model

# Install SGLang from pip:
pip install sglang
# Start the SGLang server:
python3 -m sglang.launch_server \
    --model-path "GroundingPI/GroundAnything" \
    --host 0.0.0.0 \
    --port 30000
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:30000/v1/chat/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "GroundingPI/GroundAnything",
		"messages": [
			{
				"role": "user",
				"content": [
					{
						"type": "text",
						"text": "Describe this image in one sentence."
					},
					{
						"type": "image_url",
						"image_url": {
							"url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg"
						}
					}
				]
			}
		]
	}'

Use Docker images

docker run --gpus all \
    --shm-size 32g \
    -p 30000:30000 \
    -v ~/.cache/huggingface:/root/.cache/huggingface \
    --env "HF_TOKEN=<secret>" \
    --ipc=host \
    lmsysorg/sglang:latest \
    python3 -m sglang.launch_server \
        --model-path "GroundingPI/GroundAnything" \
        --host 0.0.0.0 \
        --port 30000
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:30000/v1/chat/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "GroundingPI/GroundAnything",
		"messages": [
			{
				"role": "user",
				"content": [
					{
						"type": "text",
						"text": "Describe this image in one sentence."
					},
					{
						"type": "image_url",
						"image_url": {
							"url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg"
						}
					}
				]
			}
		]
	}'

Docker Model Runner
How to use GroundingPI/GroundAnything with Docker Model Runner:
```
docker model run hf.co/GroundingPI/GroundAnything
```

Harmonize the paper link and live upvote badge

#11

by Skywalker0410 - opened 9 days ago

base: refs/heads/main

←

from: refs/pr/11

Discussion Files changed

-3

Files changed (2) hide show

README.md +2 -2
checksums.sha256 +1 -1

README.md CHANGED Viewed

@@ -41,7 +41,7 @@ inference: false
 - 🌐 **Project Page:** [GroundAnything](https://groundingpi.github.io/groundanything/).
 - 💻 **GitHub Code:** [groundingpi/GroundAnything](https://github.com/groundingpi/GroundAnything).
 - 📄 **Paper:** [arXiv:2609.39600](https://arxiv.org/abs/2609.39600).
-- [![HF paper — live upvotes](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fhuggingface.co%2Fapi%2Fpapers%2F2609.39600&query=%24.upvotes&label=HF+paper&suffix=+upvotes&logo=huggingface&color=ffd21e&cacheSeconds=300)](https://huggingface.co/papers/2609.39600)
 # Model Overview
@@ -345,7 +345,7 @@ Grounding predictions can miss small or occluded objects, repeat instances, or p
 - 🌐 **项目主页：** [GroundAnything](https://groundingpi.github.io/groundanything/)。
 - 💻 **GitHub 代码：** [groundingpi/GroundAnything](https://github.com/groundingpi/GroundAnything)。
 - 📄 **论文：** [arXiv:2609.39600](https://arxiv.org/abs/2609.39600)。
-- [![HF paper — 实时赞同票](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fhuggingface.co%2Fapi%2Fpapers%2F2609.39600&query=%24.upvotes&label=HF+paper&suffix=+upvotes&logo=huggingface&color=ffd21e&cacheSeconds=300)](https://huggingface.co/papers/2609.39600)
 # 模型概述

 - 🌐 **Project Page:** [GroundAnything](https://groundingpi.github.io/groundanything/).
 - 💻 **GitHub Code:** [groundingpi/GroundAnything](https://github.com/groundingpi/GroundAnything).
 - 📄 **Paper:** [arXiv:2609.39600](https://arxiv.org/abs/2609.39600).
+- 🤗 **HF paper:** <a href="https://huggingface.co/papers/2609.39600"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fhuggingface.co%2Fapi%2Fpapers%2F2609.39600&amp;query=%24.upvotes&amp;label=&amp;prefix=%E2%86%91+&amp;suffix=+upvotes&amp;style=flat&amp;color=fef3c7&amp;cacheSeconds=300" height="20" style="display: inline-block; vertical-align: middle; margin: 0;" alt="Live upvotes" /></a>
 # Model Overview
 - 🌐 **项目主页：** [GroundAnything](https://groundingpi.github.io/groundanything/)。
 - 💻 **GitHub 代码：** [groundingpi/GroundAnything](https://github.com/groundingpi/GroundAnything)。
 - 📄 **论文：** [arXiv:2609.39600](https://arxiv.org/abs/2609.39600)。
+- 🤗 **HF 论文：** <a href="https://huggingface.co/papers/2609.39600"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fhuggingface.co%2Fapi%2Fpapers%2F2609.39600&amp;query=%24.upvotes&amp;label=&amp;prefix=%E2%86%91+&amp;suffix=+upvotes&amp;style=flat&amp;color=fef3c7&amp;cacheSeconds=300" height="20" style="display: inline-block; vertical-align: middle; margin: 0;" alt="实时赞同票" /></a>
 # 模型概述

checksums.sha256 CHANGED Viewed

@@ -24,5 +24,5 @@ cfc7749b96f63bd31c3c42b5c471bf756814053e847c10f3eb003417bc523d30  LICENSE-Apache
 cddaec9f528f9ebf5ac627850eefcb3f14ee55e168776a1b650f91353ce8293e  assets/demo.mp4
 3c282238bb1598093c078e57dcc1db4b3ce8fb1f39db6c09ca90e0686f1043a2  assets/demo-poster.jpg
 e0f0bbfa420324807403cfffe5ce664a33675c4e569de71b82cac7fb3b750f3e  assets/fig1-teaser.png
-4de850a509777561891f7ab98ac22a7eeb02250f944c42c8e0c0ee30ebbfe44d  README.md
 5ef0abc7d34eca644c1cdac26dd9a3b9c0204f03137827c6475afa2648420304  assets/modelscope-logo.svg

 cddaec9f528f9ebf5ac627850eefcb3f14ee55e168776a1b650f91353ce8293e  assets/demo.mp4
 3c282238bb1598093c078e57dcc1db4b3ce8fb1f39db6c09ca90e0686f1043a2  assets/demo-poster.jpg
 e0f0bbfa420324807403cfffe5ce664a33675c4e569de71b82cac7fb3b750f3e  assets/fig1-teaser.png
+670e6ba79f9a063968e255c80c58883a9d326259558093252006b00cd11fe5b7  README.md
 5ef0abc7d34eca644c1cdac26dd9a3b9c0204f03137827c6475afa2648420304  assets/modelscope-logo.svg