Awesome
Sora Python SDK
Sora Python SDK は WebRTC SFU Sora の Python クライアントアプリケーションを開発するためのライブラリです。Sora C++ SDK をベースにしています。
About Shiguredo's open source software
We will not respond to PRs or issues that have not been discussed on Discord. Also, Discord is only available in Japanese.
Please read https://github.com/shiguredo/oss/blob/master/README.en.md before use.
時雨堂のオープンソースソフトウェアについて
利用前に https://github.com/shiguredo/oss をお読みください。
Sora Python SDK について
様々なプラットフォームに対応しすぐに使い始められる WebRTC SFU Sora 向けの Python SDK です。
特徴
- Sora C++ SDK ベース
- WebRTC 部分の機能は libwebrtc を採用
- Windows / macOS / Linux (Ubuntu) プラットフォームに対応
- NVIDIA Jetson JetPack SDK に対応
- Intel / Apple / NVIDIA のハードウェアデコーダー/エンコーダーに対応
- Intel VPL (AV1 / H.264 / H.265)
- Apple Video Toolbox (H.264 / H.265)
- NVIDIA Video Codec SDK (VP9 / H.264 / H.265)
- NVIDIA Jetson JetPack SDK (AV1 / H.264 / H.265)
- OpenH264 を利用した H.264 のソフトウェアエンコーダー/デコーダーに対応
- 物体検出などの入力に Sora 経由で受信した映像が利用できる
- 音声認識などの入力に Sora 経由で受信した音声を利用できる
pip install sora_sdkでインストール可能
利用イメージ
- データチャンネルを利用して Python において映像、音声を解析した結果を Sora 経由で配信する
- Text to Speech の音声を Sora 経由で配信する
- 映像入力に対して Pillow などで加工した映像を Sora を経由で配信する
- A チャンネルの参加者からの映像と音声を B チャンネルに対して加工した上で Sora 経由で配信する
ドキュメント
サンプル集
examples を参照してください。
sora_sdk パッケージの追加
pip
pip install sora_sdk
Rye
rye add sora_sdk
rye sync
NVIDIA Jetson 向けパッケージ
PyPI 経由ではインストールできません。 パッケージバイナリを配布しておりますので、そちらをご利用ください。
システム条件
- WebRTC SFU Sora 2023.2.0 以降
- Python 3.10 以上
対応プラットフォーム
- Windows 11 x86_64
- Windows Server 2022 x86_64
- macOS Ventura 14 arm64
- macOS Sonoma 13 arm64
- Ubuntu 24.04 LTS x86_64
- Ubuntu 22.04 LTS x86_64
- Ubuntu 22.04 LTS arm64 (NVIDIA Jetson JetPack SDK 6)
- PyPI からではなくパッケージファイルを利用してください
対応機能
- Sora の機能へ追従
- VP8 / VP9 / AV1 / H.264 / H.265 のハードウェアアクセラレーター (HWA) 対応
- OpenH264 を利用した H.264 のソフトウェアエンコーダー/デコーダーへの対応
優先実装
優先実装とは Sora のライセンスを契約頂いているお客様向けに Sora Python SDK の実装予定機能を有償にて前倒しで実装することです。
詳細は Discord やメールなどでお気軽にお問い合わせください
- DataChannel 対応
- Intel VPL H.265 対応
優先実装が可能な機能一覧
詳細は Discord やメールなどでお気軽にお問い合わせください
- Windows 11 arm64
- Ubuntu 24.04 arm64
- Ubuntu 22.04 arm64
- Ubuntu 20.04 arm64 (NVIDIA Jetson JetPack SDK 5)
- AMD Video Core Next (VCN) 対応
- VP9 / AV1 / H.264 / H.265
- Python 3.9 以前への対応
サポートについて
Discord
- サポートしません
- アドバイスします
- フィードバック歓迎します
最新の状況などは Discord で共有しています。質問や相談も Discord でのみ受け付けています。
バグ報告
Discord へお願いします。
ライセンス
Apache License 2.0
Copyright 2023-2024, tnoho (Original Author)
Copyright 2023-2024, Wandbox LLC (Original Author)
Copyright 2023-2024, Shiguredo Inc.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
このリポジトリに含まれる shiguremaru.png ファイルのライセンスは CC BY-NC-ND 4.0 です。
OpenH264
https://www.openh264.org/BINARY_LICENSE.txt
"OpenH264 Video Codec provided by Cisco Systems, Inc."