This release is a pre-release and may not be stable for production use.
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 です。
音声や映像デバイスの処理を SDK から独立させているため、様々なライブラリを利用する事ができます。
特徴
- PyPI 経由で
uv add sora-sdkやpip install sora-sdkでインストールできる - Raspberry Pi 向けパッケージ
sora-sdk-rpiの提供uv add sora-sdk-rpiでインストールできる
- Raspberry Pi 向けに libcamera 用の
create_libcamera_sourceを提供 - Sora C++ SDK ベース
- WebRTC 部分の機能は libwebrtc を採用
- Windows / macOS / Linux (Ubuntu / Raspberry Pi OS) プラットフォームに対応
- WebRTC 統計情報 の取得が可能
- WebRTC Encoded Transform に対応
- 回線が不安定になった際、解像度とフレームレートどちらを維持するかの設定をする DegradationPreference に対応
MAINTAIN_FRAMERATE/MAINTAIN_RESOLUTION/BALANCEDが指定できる
- 発話区間の検出が可能な VAD (Voice Activity Detection) に対応
- Intel / Apple / NVIDIA / Raspberry Pi のハードウェアデコーダー/エンコーダーに対応
- Apple Video Toolbox (H.264 / H.265)
- macOS arm64 で利用できる
- Intel VPL (VP9 / AV1 / H.264 / H.265)
- Ubuntu x86_64 / Windows x86_64 で利用できる
- AMD AMF (VP9 /AV1 / H.264 / H.265)
- Ubuntu x86_64 / Windows x86_64 で利用できる
- AV1 エンコードは Windows x86_64 でのみ利用できる
- VP9 はデコードのみ利用できる
- NVIDIA Video Codec (VP8 / VP9 / AV1 / H.264 / H.265)
- Ubuntu x86_64 / Windows x86_64 で利用できる
- VP8 と VP9 はデコードのみ利用できる
- NVIDIA Jetson JetPack SDK (AV1 / H.264 / H.265)
- Raspberry Pi (H.264)
- Raspberry Pi 4 / Raspberry Pi 3 / Raspberry Pi 2 Model B v1.2 / Raspberry Pi Zero 2 W で利用できる
- V4L2-M2M API を利用している
- 各プラットフォームで利用可能な HWA への対応
- Apple Video Toolbox (H.264 / H.265)
- OpenH264 を利用した H.264 のソフトウェアエンコーダー/デコーダーに対応
- Ubuntu x86_64 / Ubuntu arm64 / Windows x86_64 / macOS arm64 で利用できる
- 音声デバイス処理に sounddevice などが利用できる
- 映像デバイス処理に opencv-python などが利用できる
- 音声認識などの入力に受信した音声を利用できる
- 物体検出などの入力に受信した映像を利用できる
- NVIDIA Jetson JetPack SDK に対応
利用イメージ
- データチャンネルを利用して Python において映像、音声を解析した結果を Sora 経由で配信する
- Text to Speech の音声を Sora 経由で配信する
- 映像入力に対して Pillow などで加工した映像を Sora を経由で配信する
- A チャンネルの参加者からの映像と音声を B チャンネルに対して加工した上で Sora 経由で配信する
ドキュメント
サンプル集
shiguredo/sora-python-sdk-examples
sora_sdk パッケージの追加
uv の利用を推奨します。
uv add sora_sdk
Raspberry Pi OS 向けパッケージ
uv add sora_sdk_rpi
NVIDIA Jetson 向けパッケージ
PyPI 経由ではインストールできません。 パッケージバイナリを配布しておりますので、そちらをご利用ください。
https://github.com/shiguredo/sora-python-sdk/releases/tag/2024.3.0-jetson-jetpack-6.0.0.0
対応 WebRTC SFU Sora
直近 2 バージョンの Sora をサポートします
- Sora 2026.1.x
- Sora 2025.2.x
Python サポートポリシー
直近の 3 バージョンの Python をサポートします。
- Python 3.14
- Python 3.13
- Python 3.12
Scientific Python - SPEC 0 — Minimum Supported Dependencies
対応プラットフォーム
- Ubuntu 26.04 LTS x86_64
- Ubuntu 26.04 LTS arm64
- Ubuntu 24.04 LTS x86_64
- Ubuntu 24.04 LTS arm64
- macOS Tahoe 26 arm64
- macOS Sequoia 15 arm64
- Windows 11 x86_64
- Windows Server 2025 x86_64
- Raspberry Pi OS armv8
Raspberry Pi OS 向け
- Raspberry Pi OS Trixie (64bit)
- Raspberry Pi 5
- Raspberry Pi 4
- Raspberry Pi 3
- Raspberry Pi 2 Model B v1.2
- Raspberry Pi Zero 2 W
NVIDIA Jetson 向け
- Ubuntu 22.04 LTS arm64 (NVIDIA Jetson JetPack SDK 6)
- PyPI からではなくパッケージファイルを利用してください
Ubuntu の対応バージョン
直近の LTS 2 バージョンをサポートします。
macOS の対応バージョン
直近の 2 バージョンをサポートします。
優先実装
優先実装とは Sora のライセンスを契約頂いているお客様向けに Sora Python SDK の実装予定機能を有償にて前倒しで実装することです。
詳細は Discord やメールなどでお気軽にお問い合わせください
- DataChannel 対応
- Intel VPL H.265 対応
優先実装が可能な機能一覧
- Ubuntu 22.04 対応
- Ubuntu 22.04 arm64 (NVIDIA Jetson JetPack SDK 6.1)
サポートについて
Discord
- サポートしません
- アドバイスします
- フィードバック歓迎します
最新の状況などは Discord で共有しています。質問や相談も Discord でのみ受け付けています。
バグ報告
Discord へお願いします。
ライセンス
Apache License 2.0
Copyright 2023 tnoho (Original Author)
Copyright 2023 Wandbox LLC (Original Author)
Copyright 2023 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.
OpenH264
https://www.openh264.org/BINARY_LICENSE.txt
"OpenH264 Video Codec provided by Cisco Systems, Inc."
NVDIA Video Codec SDK
https://docs.nvidia.com/video-technologies/video-codec-sdk/12.2/license/index.html
“This software contains source code provided by NVIDIA Corporation.”
H.264 (AVC) と H.265 (HEVC) のライセンスについて
時雨堂が提供する libwebrtc のビルド済みバイナリには H.264 と H.265 のコーデックは含まれていません
H.264
H.264 対応は Via LA Licensing (旧 MPEG-LA) に連絡を取り、ロイヤリティの対象にならないことを確認しています。
時雨堂がエンドユーザーの PC /デバイスに既に存在する AVC / H.264 エンコーダー/デコーダーに依存する製品を提供する場合は、 ソフトウェア製品は AVC ライセンスの対象外となり、ロイヤリティの対象にもなりません。
H.265
H.265 対応は以下の二つの団体に連絡を取り、H.265 ハードウェアアクセラレーターのみを利用し、 H.265 が利用可能なバイナリを配布する事は、ライセンスが不要であることを確認しています。
また、H.265 のハードウェアアクセラレーターのみを利用した H.265 対応の SDK を OSS で公開し、 ビルド済みバイナリを配布する事は、ライセンスが不要であることも確認しています。
Release files for sora-sdk-rpi 2026.1.0.dev18
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| sora_sdk_rpi-2026.1.0.dev18-cp314-cp314-manylinux_2_35_aarch64.whl | CPython 3.14 | CPython 3.14 | Linux glibc 2.35+ ARM64 | Details |
| sora_sdk_rpi-2026.1.0.dev18-cp313-cp313-manylinux_2_35_aarch64.whl | CPython 3.13 | CPython 3.13 | Linux glibc 2.35+ ARM64 | Details |
| sora_sdk_rpi-2026.1.0.dev18-cp312-cp312-manylinux_2_35_aarch64.whl | CPython 3.12 | CPython 3.12 | Linux glibc 2.35+ ARM64 | Details |
Total release size: 24.2 MB
Release files / sora_sdk_rpi-2026.1.0.dev18-cp314-cp314-manylinux_2_35_aarch64.whl
| Download URL | sora_sdk_rpi-2026.1.0.dev18-cp314-cp314-manylinux_2_35_aarch64.whl |
|---|---|
| Size | 8.1 MB |
| Tags | CPython 3.14 Linux glibc 2.35+ ARM64 |
|
SHA-256 checksum How to use checksums |
36ac88d2ef28e11a64f7114e7bcb81f655edc70c414a59c2e962b25bad447838
|
|
BLAKE2b-256 checksum How to use checksums |
5842889b23316f6f0f06129f0e5ab1187f3e079115de20ac0aca1a09fd276e69
|
| 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 Aug 24, 2026.
Transparency logRelease files / sora_sdk_rpi-2026.1.0.dev18-cp313-cp313-manylinux_2_35_aarch64.whl
| Download URL | sora_sdk_rpi-2026.1.0.dev18-cp313-cp313-manylinux_2_35_aarch64.whl |
|---|---|
| Size | 8.1 MB |
| Tags | CPython 3.13 Linux glibc 2.35+ ARM64 |
|
SHA-256 checksum How to use checksums |
196ab50a6d3930bd833e8b4f623b4107089a7f8ed1281c60affadc7ddcfa03d1
|
|
BLAKE2b-256 checksum How to use checksums |
18d6160a5bf0f945f69228b6c3df08efd86f078741e4921ef2599c45616c0a28
|
| 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 Aug 24, 2026.
Transparency logRelease files / sora_sdk_rpi-2026.1.0.dev18-cp312-cp312-manylinux_2_35_aarch64.whl
| Download URL | sora_sdk_rpi-2026.1.0.dev18-cp312-cp312-manylinux_2_35_aarch64.whl |
|---|---|
| Size | 8.1 MB |
| Tags | CPython 3.12 Linux glibc 2.35+ ARM64 |
|
SHA-256 checksum How to use checksums |
ec5363102599cc9720912db1f3ec6d6492fa7f58f3306aba0fc0d669720a4c52
|
|
BLAKE2b-256 checksum How to use checksums |
e7e958946a3db488da5dfe4770d0a44bef84ac89bf8748a353768e60bc425fca
|
| 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 Aug 24, 2026.
Transparency log
