T2D2 SDK
A Python SDK for seamless integration with the T2D2 platform.
Easily manage projects, assets, and AI-powered inspections for structural health monitoring.
Description
T2D2 SDK is a Python wrapper for the T2D2 API, enabling seamless integration with T2D2 projects and related assets for structural inspection data management.
- Manage projects, images, annotations, drawings, videos, reports, and more
- Upload, download, and organize assets
- Run AI inference and summarize inspection data
- Integrate with T2D2's web platform
Documentation
Full documentation is available at: https://t2d2-ai.github.io/t2d2-sdk/
Table of Contents
Features
- Authentication: API key or email/password
- Project Management: Set, get, and summarize projects
- Asset Management: Upload/download images, drawings, videos, 3D models, and reports
- Annotations: Add, retrieve, and manage annotation classes and annotations
- Regions & Tags: Organize assets by regions and tags
- AI Integration: Run AI inference on images using project models
- Summarization: Summarize images and annotation conditions
- Notifications: Send notifications to users or Slack
Installation
Install the latest version from PyPI:
pip install --upgrade t2d2-sdk
Quickstart
- Sign up for a T2D2 account: Register here
- Get your API key from the T2D2 web app
- Initialize the client:
from t2d2_sdk import T2D2
credentials = {'api_key': '<YOUR_API_KEY>'}
t2d2 = T2D2(credentials)
Usage
Set Project
t2d2.set_project('<PROJECT_ID>')
project_info = t2d2.get_project_info()
print(project_info)
Upload Images
image_paths = ['./images/img1.jpg', './images/img2.jpg']
response = t2d2.upload_images(image_paths)
print(response)
Get Images
images = t2d2.get_images()
for img in images:
print(img['filename'], img['id'])
Add Annotation Class
result = t2d2.add_annotation_class('Crack', color='#FF0000', materials=['Concrete'])
print(result)
Add Annotations to an Image
annotations = [
{
'annotation_class_id': 'class_id',
'coordinates': [[100, 100], [200, 100], [200, 200], [100, 200]],
'attributes': {'severity': 'high'}
}
]
result = t2d2.add_annotations('image_id', annotations)
print(result)
Run AI Inference
result = t2d2.run_ai_inferencer(
image_ids=['image_id1', 'image_id2'],
model_id='model_id',
confidence_threshold=0.6
)
print(result)
For more advanced usage, see the full documentation.
Contributing
Contributions are welcome! Please contact bhiriyur@t2d2.ai for more information.
License
See the LICENSE file for details.
Support
- Documentation: https://t2d2-ai.github.io/t2d2-sdk/
- Email: bhiriyur@t2d2.ai
- T2D2 Web: https://t2d2.ai
1 maintainer
Metadata
1 maintainer
Release files for t2d2-sdk 2.6.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| t2d2_sdk-2.6.1.tar.gz | 131.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| t2d2_sdk-2.6.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 186.0 kB
Release files / t2d2_sdk-2.6.1.tar.gz
| Download URL | t2d2_sdk-2.6.1.tar.gz |
|---|---|
| Size | 131.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
81b719d761522e8aeebba45d535aa439b2ca01e20dc731f33b66ed8ab0dce3d1
|
|
BLAKE2b-256 checksum How to use checksums |
42a3cc870ffdae1b85f05768e1dd0a51c5edca6e4fe3fafb07c8bf3bb8fc5ba4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 1, 2026.
Transparency logRelease files / t2d2_sdk-2.6.1-py3-none-any.whl
| Download URL | t2d2_sdk-2.6.1-py3-none-any.whl |
|---|---|
| Size | 54.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
50d46073079d59d93b13e2fd4eb48988cca4bc8f377642464ba20dfdceb00e3c
|
|
BLAKE2b-256 checksum How to use checksums |
6deacb3bfbff3336d060f0bdfa8e5d96b67857edb91b7135669a1ad69ec20781
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 1, 2026.
Transparency log
