Sora Python SDK 概要

Sora Python SDK は 株式会社時雨堂WebRTC SFU Sora の Python 向けクライアントフレームワークです。

特徴

Sora Python SDK は Sora C++ SDK をラップした Python 向けのライブラリです。 そのため、 Sora C++ SDK がサポートする機能のほとんどを利用する事ができます。

Sora C++ SDK が libwebrtc を利用している事もあり、ブラウザで利用する WebRTC と同じ機能が利用できます。

ハードウェアアクセラレーター

時雨堂が独自に様々なハードウェアアクセラレーターに対応することで、CPU 負荷を抑えて高画質な映像配信を行う事ができます。

  • Apple macOS Video Toolbox
    • H.264 / H.265
    • VP9 / AV1 のデコードには対応していません
  • NVIDIA Video Codec
    • VP8 / VP9 / H.264 / H.265
    • VP8 / VP9 はデコードのみの対応です
  • Intel VPL (Intel Media SDK の後継)
    • VP9 / AV1 / H.264 / H.265
  • AMD AMF
    • VP8 / VP9 /AV1 / H.264 / H.265
    • AV1 のデコードは Ubuntu x86_64 のみ対応です
    • VP8 / VP9 はデコードのみの対応です

ソフトウェアコーデック

libwebrtc に含まれている VP8 / VP9 / AV1 に対応しています。

また、 OpenH264 を利用する事でハードウェアアクセラレーターが利用できない環境でも H.264 を利用する事ができます。

OpenH264 は Ubuntu x86_64 と macOS arm64 環境で利用できます。

NVIDIA Jetson JetPack SDK 対応

NVIDIA Jetson JetPack SDK で利用できる wheel ファイルを提供しています。

NVIDIA Jetson

  • Ubuntu 22.04 arm64
    • NVIDIA Jetson JetPack 6 に対応
    • Python 3.10 のみ対応

詳細は NVIDIA Jetson JetPack SDK をご確認ください。

ソースコード

https://github.com/shiguredo/sora-python-sdk

サンプルソースコード

https://github.com/shiguredo/sora-python-sdk の examples ディレクトリ

動作環境

対応 Python バージョン

  • Python 3.14
  • Python 3.13
  • Python 3.12
  • Python 3.11

対応プラットフォーム

  • Ubuntu 24.04 LTS x86_64
  • Ubuntu 24.04 LTS arm64
  • Ubuntu 22.04 LTS x86_64
  • Ubuntu 22.04 LTS arm64 (NVIDIA Jetson JetPack 6) - PyPI 経由でのインストールには対応していません
  • macOS Tahoe 26 arm64
  • macOS Sequoia 15 arm64
  • macOS Ventura 14 arm64
  • Windows 11 x86_64
  • Windows Server 2025 x86_64

対応 Sora

リリースノート をご確認ください

対応 OpenH264

OpenH264 のバージョンは 2.6.0 をサポートします。

対応 Python サポート方針

リリースのタイミングで、直近の 3 バージョンをサポートします。

これは Scientific Python の SPEC 0 を参考にしてます。

例えば 2024 年 12 月にリリースした場合は、2024 年 10 月に Python 3.13 がリリースされているため、 Python 3.11, 3.12, 3.13 をサポートします。

古い Python バージョンのサポートについて

サポート終了後も優先実装にて対応が可能ですので、 Sora サポートまでお問い合わせください。

対応プラットフォームサポート方針

Windows サポート方針

最新の 1 バージョンのみをサポートします。

  • Windows 11
    • Windows 12 リリース後、12 ヶ月以内に通常サポート終了します
  • Windows Server 2022
    • Windows Server 2025 リリース後、12 ヶ月以内に通常サポート終了します

macOS サポート方針

最新の 2 バージョンのみをサポートします。

  • macOS 15
    • macOS 17 リリース後、12 ヶ月以内に通常サポート終了します
  • macOS 14
    • macOS 16 リリース後、12 ヶ月以内に通常サポート終了します

Ubuntu LTS サポート方針

最新の 2 バージョンのみをサポートします。

  • Ubuntu 24.04 LTS
    • Ubuntu 28.04 リリース後、12 ヶ月以内に通常サポート終了します
  • Ubuntu 22.04 LTS
    • Ubuntu 26.04 リリース後、12 ヶ月以内に通常サポート終了します

NVIDIA Jetson JetPack SDK サポート方針

最新の 1 バージョンのみをサポートします。

  • Jetson JetPack SDK 6
    • Jetson JetPack SDK 7 リリース後、12 ヶ月以内に通常サポート終了します

古い OS バージョンのサポートについて

サポート終了後も優先実装にて対応が可能ですので、 Sora サポートまでお問い合わせください。

問い合わせについて

Sora Python SDK の質問などについては Discord の #sora-sdk-faq チャンネルにお願いします。 ただし、 Sora のライセンス契約の有無に関わらず、応答時間と問題の解決を保証しませんのでご了承ください。

https://discord.gg/shiguredo

またビルドやパッケージングに関する質問に対しては、コミュニティ管理者は回答は行いません。