Eclipse Tractus-X SDK Documentation
Welcome to the Eclipse Tractus-X Software Development Kit (SDK) - your gateway to building powerful dataspace native applications, services and AI models.
Installation
The Tractus-X SDK is published on PyPI and requires Python 3.12 or later.
Basic Installation
Install a Specific Version
Verify the Installation
The package index is available at https://pypi.org/project/tractusx-sdk/.
Note: It is strongly recommended to install the SDK inside a virtual environment (
venv,conda, or similar) to avoid dependency conflicts.
# Create and activate a virtual environment
python3.12 -m venv .venv
source .venv/bin/activate # macOS / Linux
.venv\Scripts\activate # Windows
# Then install the SDK
pip install tractusx-sdk
What is this SDK?
The Tractus-X SDK is a Python library that makes it easier to work with dataspaces. Think of it as a toolbox that handles the complicated parts of sharing and accessing data in the Tractus-X network, so you can focus on building your application.
Whether you're sharing data with partners or pulling data from providers, this SDK handles the connector setup, authentication, policies, and all the protocol details for you.
What you get
- Work with Eclipse Dataspace Connectors without dealing with low-level APIs
- Built-in support for industry data models (parts, batteries, digital twins, etc.)
- Discover what data is available across the network
- Handle authentication and access policies automatically
- Pick only the parts you need - it's modular
- Get started fast with ready-to-run examples
Why we built this
Working with dataspaces involves a lot of moving parts: connectors, registries, discovery services, policies, negotiations. Each component has its own API, version quirks, and protocol requirements.
We built this SDK to hide that complexity. It gives you simple Python methods that work across different EDC versions, handles backward compatibility automatically, and follows the patterns recommended by Tractus-X KITs.
The goal is simple: make it easy to join the dataspace without being a dataspace expert.
Based on Tractus-X KITs
The SDK implements the official Tractus-X standards:
- Connector KIT - working with EDC connectors
- Digital Twin KIT - digital twins and registries
- Industry Core KIT - industry data models
Who is this for?
Developers
You're building apps that need to share or access data in Tractus-X. Maybe you're connecting an existing system, building a new microservice, or just experimenting with dataspace tech.
Companies and integrators
Your organization is joining Tractus-X, or you're implementing dataspace solutions for clients. You need something that works now and won't break when standards evolve.
Students and researchers
You're learning about dataspaces, running experiments, or building proofs of concept. The SDK lets you focus on your ideas instead of wrestling with connector APIs.
Data teams
You manage data catalogs, build data pipelines, or implement governance policies. The SDK gives you programmatic access to the whole dataspace infrastructure.
Quick Links
Getting Started
- Installation Guide - Set up your development environment
- Create Your First Asset - Start sharing data in minutes
Learn the Concepts
- Dataspace Library - Working with connectors and the EDC
- Industry Library - Digital Twin Registry and submodel servers
- Extension Library - Use case-specific add-ons
- Backward Compatibility Guide - Migrating between Jupiter and Saturn, handling different EDC versions
Code and Community
- GitHub Repository - Source code, issues, and discussions
- PyPI Package - Install via pip
- Changelog - What's new in each release
- Contributing Guidelines - How to contribute
- Weekly Meetings - Join the developer community
More Resources
- Eclipse Tractus-X - Main project website
- Tractus-X KITs - Official specifications and standards
New to dataspaces?
Check out the Getting Started Guide - it takes about 10 minutes and shows you how the whole thing works.
Current release: 0.7.1
Requires Python 3.12+
License: Apache 2.0 (code) / CC-BY-4.0 (docs)
NOTICE
This work is licensed under the CC-BY-4.0.
- SPDX-License-Identifier: CC-BY-4.0
- SPDX-FileCopyrightText: 2025, 2026 Contributors to the Eclipse Foundation
- SPDX-FileCopyrightText: 2025, 2026 Catena-X Automotive Network e.V.
- SPDX-FileCopyrightText: 2025, 2026 LKS Next
- SPDX-FileCopyrightText: 2025, 2026 Mondragon Unibertsitatea
- Source URL: https://github.com/eclipse-tractusx/tractusx-sdk