tencentmusic/supersonic

これは何？

主な機能

• 01ビジネスユーザー向けに、自然言語でのクエリとチャートの自動表示を提供。
• 02指標、ディメンション、エンティティ間の関係を定義できるヘッドレスのセマンティックレイヤー。
• 03ルールベースとLLMベースを組み合わせたセマンティック解析・補正。
• 04データセット、カラム、行の各レベルでのアクセス制御。
• 05複数ターンの会話、入力補完、クエリ後のおすすめ機能。
• 06Java SPIとサードパーティ製チャットプラグインによる拡張。

ユースケース

• 技術者以外のスタッフが、社内データについて自然な言葉で質問できるようにする。
• ダッシュボードとLLMの両方が参照する、ガバナンスの効いたセマンティックモデルを構築する。
• 既存の指標レイヤー上に自然言語APIを追加する。
• ルールベースとLLMのコンポーネントを組み合わせたText2SQLパイプラインを試作する。

クイックスタート

1. 1

   デプロイごとに固有のJWT署名シークレットを設定する

   export SUPERSONIC_JWT_SECRET="$(openssl rand -hex 64)"
2. 2

   docker-compose.ymlファイルをダウンロードする

   wget https://raw.githubusercontent.com/tencentmusic/supersonic/master/docker/docker-compose.yml
3. 3

   docker-composeでサービスを起動する

   docker-compose up -d
4. 4

   ブラウザーでhttp://localhost:9080を開く

使う前に知っておきたいこと

• !ライセンスは不明確（NOASSERTIONと記載）なため、商用利用の前にリポジトリのライセンス条件を確認してください。
• !JWTシークレットが適切に設定されていないとアプリは起動しないため、まず生成して保存する必要があります。

トピック

よくある質問

supersonic とは？

LLMベースの自然言語クエリ（Chat BI）と、セマンティックレイヤーを基盤とするHeadless BIインターフェースを組み合わせたAI+BIプラットフォーム。 SuperSonicは、分析エンジニアが指標やディメンション、その関係を定義するヘッドレスのセマンティックレイヤーと、ビジネスユーザーが質問するとチャートで回答する自然言語クエリインターフェースを組み合わせた、オープンソースの分析プラットフォームです。セマンティックモデルは両方の経路で利用されます。LLMベースのText2SQLパイプラインでは、モデルをコンテキスト検索に使って、実在しないフィールドの生成を抑制します。同じモデルはHeadless BIクエリAPIからも利用できます。

supersonic は無料で使えますか？ライセンスは？

supersonic は Other ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

supersonic は今もメンテナンスされていますか？

活発にメンテナンス中。supersonic の最終コミットは 2026年10月15日 です。

supersonic は何に使えますか？

技術者以外のスタッフが、社内データについて自然な言葉で質問できるようにする。 ダッシュボードとLLMの両方が参照する、ガバナンスの効いたセマンティックモデルを構築する。 既存の指標レイヤー上に自然言語APIを追加する。 ルールベースとLLMのコンポーネントを組み合わせたText2SQLパイプラインを試作する。

supersonic のインストール方法は？

デプロイごとに固有のJWT署名シークレットを設定する: export SUPERSONIC_JWT_SECRET="$(openssl rand -hex 64)" docker-compose.ymlファイルをダウンロードする: wget https://raw.githubusercontent.com/tencentmusic/supersonic/master/docker/docker-compose.yml docker-composeでサービスを起動する: docker-compose up -d ブラウザーでhttp://localhost:9080を開く

supersonic はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/tencentmusic/supersonic