🚨 Repository Archived — Project has moved!

This repository is no longer maintained and has been archived.

➡️ The active development now continues at:
🔗 https://labs.etsi.org/rep/oop/code/tf-sdk

OpenSDK

Open source SDK to abstract CAMARA/GSMA Transformation Functions (TFs) for Edge Cloud platforms, 5G network cores and O-RAN solutions.

Features

• Abstract CAMARA Transformation Functions (TFs)
• Unified Python SDK for interacting with Edge Cloud platforms, 5G Core solutions, and O-RAN solutions.
• Modular and extensible adapter structure

---

API & Platform Support Matrix

CAMARA APIs

API Name	Version
Edge Application Management	v0.9.3-wip (commit: 79aa595)
Quality-on-Demand	v1.0.0
Location Retrieval	v0.4.0
Traffic Influence	v0.8.1

EdgeCloud Platforms

Platform	Status
Kubernetes	✅
i2Edge	✅
aerOS	✅

Network Adapters

Platform	NEF Version	QoD	Location Retrieval	Traffic Influence
Open5GS	v1.2.3 TS 29.122 (v17.12.0)	✅	✅	❌
Open5GCore	v1.2.3 TS 29.122 (v17.12.0)	✅	❌	❌
OAI	v1.2.3 TS 29.122 (v17.12.0)	✅	❌	✅

---

How to Use

Option 1: Install via PyPI

For end users:

pip install sunrise6g-opensdk

Option 2: Development Mode

If you plan to modify the SDK:

git clone https://github.com/SunriseOpenOperatorPlatform/open-sdk.git
cd open-sdk
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
pip install -e .

Basic Usage

You can use the SDK by simply specifying the adapters to be used. E.g. Edge Cloud Platform: i2Edge, 5G core: Open5Gs

Example available in /examples/example.py

python3 -m examples.example

---

How to Contribute

We welcome contributions to OpenSDK!

To get started:

1. Fork the repository and create a branch from main.
2. Add your changes in the appropriate adapter directory.
3. Write or update tests for your changes.
4. Ensure all tests and pre-commit checks pass.
5. Submit a pull request with a clear description.

Please follow our full Contributing Guidelines for further details.

---

Example Workflow #1: App deployment over Kubernetes

sequenceDiagram
title Application Deployment using the Open SDK

actor AP as Application Vertical Provider
box Module implementing CAMARA APIs
    participant API as CAMARA Edge Application Management API
    participant SDK as Open SDK
end
participant K8s as Kubernetes

note over SDK: [Config] Edge Cloud platform: Kubernetes, IP, Port
API ->> SDK: from sunrise6g_opensdk import Sdk as sdkclient
API ->> SDK: sdkclient.create_adapters_from(configuration)
API ->> SDK: edgecloud_client = adapters.get("edgecloud")
SDK ->> SDK: SDK initialized and ready to be used
note over AP,API: Platform ready to receive CAMARA calls
AP ->> API: POST /app (APP_ONBOARD_MANIFEST)
API ->> SDK: edgecloud_client.onboard_app(APP_ONBOARD_MANIFEST)
SDK ->> K8s: Equivalent dedicated endpoint
AP ->> API: POST /appinstances (APP_ID, APP_ZONES)
API ->> SDK: edgecloud_client.deploy_app(APP_ID, APP_ZONES)
SDK ->> K8s: Equivalent dedicated endpoint

Loading

Example Workflow #2: QoS Session Creation over Open5Gs

sequenceDiagram
title QoS Session Creation over Open5GS

actor AP as Application Vertical Provider
box Module implementing CAMARA APIs
    participant API as CAMARA QoS Management API
    participant SDK as Open SDK
end
participant NEF as NEF
participant 5GS as Open5GS

note over SDK: [Config] Network core: Open5Gs, IP, Port
API ->> SDK: from sunrise6g_opensdk import Sdk as sdkclient
API ->> SDK: sdkclient.create_adapters_from(configuration)
API ->> SDK: network_client = adapters.get("network")
SDK ->> SDK: SDK initialized and ready to be used
note over AP,API: Platform ready to receive CAMARA calls
AP ->> API: POST /sessions (QOS_SESSION_REQUEST)
API ->> SDK: network_client.create_qos_session(QOS_SESSION_REQUEST)
SDK ->> NEF: Equivalent endpoint
NEF ->> 5GS: QoS session creation

Loading

---

Roadmap for Open SDK 2nd release

• Add support to GSMA OPG.02 TFs
• Include JUNIPER O-RAN adapter

---

License

Apache 2.0 License – see LICENSE file for details.