Sinapsis Hugging Face Grounding DINO
Templates for seamless integration with Grounding DINO models
🐍 Installation • 📦 Features • ▶️ Example Usage • 🌐 Webapp • 📙 Documentation • 🔍 License
🐍 Installation
Install using your package manager of choice. We encourage the use of uv
Example with uv:
uv pip install sinapsis-huggingface-grounding-dino --extra-index-url https://pypi.sinapsis.tech
or with raw pip:
pip install sinapsis-huggingface-grounding-dino --extra-index-url https://pypi.sinapsis.tech
with uv:
uv pip install sinapsis-huggingface-grounding-dino[all] --extra-index-url https://pypi.sinapsis.tech
or with raw pip:
pip install sinapsis-huggingface-grounding-dino[all] --extra-index-url https://pypi.sinapsis.tech
📦 Features
The templates in this package include functionality for different Grounding DINO-based tasks:
- GroundingDINO: Detect objects with bounding boxes based on text prompts (zero-shot object detection).
- GroundingDINOClassification: Classify images using predefined classes or text prompts, handling as many classes as possible within token limits.
- GroundingDINOFineTuning: Fine-tune Grounding DINO checkpoints on custom datasets.
▶️ Example Usage
Below is an example YAML configuration for zero-shot object detection using Grounding DINO.
Config
agent:
name: grounding_dino_detection
templates:
- template_name: InputTemplate
class_name: InputTemplate
attributes: {}
- template_name: FolderImageDatasetCV2
class_name: FolderImageDatasetCV2
template_input: InputTemplate
attributes:
data_dir: my_dataset
- template_name: GroundingDINO
class_name: GroundingDINO
template_input: FolderImageDatasetCV2
attributes:
model_path: IDEA-Research/grounding-dino-base
inference_mode: zero_shot
text_input: a person.
device: cuda
threshold: 0.2
text_threshold: 0.3
- template_name: BBoxDrawer
class_name: BBoxDrawer
template_input: GroundingDINO
attributes:
overwrite: true
randomized_color: false
- template_name: ImageSaver
class_name: ImageSaver
template_input: BBoxDrawer
attributes:
save_dir: ./output_dir
extension: png
To run the config, use the CLI:
sinapsis run name_of_config.yml
🌐 Webapp
Th Sinapsis web applications provide an interactive way to explore and experiment with AI models. They allow users to generate outputs, test different inputs, and visualize results in real time, making it easy to experience the capabilities of each model. Below are the available webapps and instructions to launch them.
git clone git@github.com:Sinapsis-ai/sinapsis-huggingface.git
cd sinapsis-huggingface
🐳 Build with Docker
IMPORTANT The docker image depends on the sinapsis-nvidia:base image. To build it, refer to the [official sinapsis documentation](https://
- Build the sinapsis-huggingface image:
docker compose -f docker/compose.yaml build
- Start the container:
docker compose -f docker/compose_vision.yaml up sinapsis-huggingface-vision-gradio -d
- Check the status:
docker logs -f sinapsis-huggingface-vision-gradio
- The logs will display the URL to access the webapp, e.g.,:
Running on local URL: http://127.0.0.1:7860
NOTE: The local URL can be different, please check the logs
- To stop the app:
docker compose -f docker/compose_vision.yaml down
📦 UV
- Create the virtual environment and sync the dependencies:
uv sync --frozen
- Install the dependencies:
uv pip install sinapsis-huggingface[all] --extra-index-url https://pypi.sinapsis.tech
- Run the webapp.
uv run webapps/vision_demo.py
- The terminal will display the URL to access the webapp, e.g., :
Running on local URL: http://127.0.0.1:7860
📙 Documentation
Documentation is available on the sinapsis website
Tutorials for different projects within sinapsis are available at sinapsis tutorials page
🔍 License
This project is licensed under the AGPLv3 license, which encourages open collaboration and sharing. For more details, please refer to the LICENSE file.
For commercial use, please refer to our official Sinapsis website for information on obtaining a commercial license.
Metadata
Release files for sinapsis-huggingface-grounding-dino 0.1.12
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| sinapsis_huggingface_grounding_dino-0.1.12.tar.gz | 25.0 kB | Without provenance | Details for sinapsis_huggingface_grounding_dino-0.1.12.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| sinapsis_huggingface_grounding_dino-0.1.12-py3-none-any.whl | Python 3 | none | any | Details for sinapsis_huggingface_grounding_dino-0.1.12-py3-none-any.whl |
Total release size: 50.4 kB
Release files / sinapsis_huggingface_grounding_dino-0.1.12.tar.gz
| Download URL | sinapsis_huggingface_grounding_dino-0.1.12.tar.gz |
|---|---|
| Size | 25.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3e4601ee24bbfb1ee00b834ad115ed470780562fb4a312dfb21a66d0ff42622a
|
|
BLAKE2b-256 checksum How to use checksums |
9208bda7663b71c62f92606cf41e6f45d631b2e6a382774ea2c3b394b739565d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.5.16
|
Release files / sinapsis_huggingface_grounding_dino-0.1.12-py3-none-any.whl
| Download URL | sinapsis_huggingface_grounding_dino-0.1.12-py3-none-any.whl |
|---|---|
| Size | 25.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f65a7603a39ff2116f278a50172aaee652d87e2f7ff6f66e97061b0196a7781b
|
|
BLAKE2b-256 checksum How to use checksums |
f2ea2c6539d31f1160d3b3ed34cc646a66c05aaa68518b82c4b76ede97f723c7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.5.16
|
Security for sinapsis-huggingface-grounding-dino 0.1.12
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.