遠隔リハビリテーション（Telerehabilitation Demo）

Web
遠隔リハビリテーション（Telerehabilitation Demo）

遠隔リハビリテーション（Telerehabilitation Demo）

本リポジトリは、筋骨格系の遠隔リハビリをローカルで実演するデモプロジェクトです。フロントエンドにReact＋Vite＋MediaPipeを用いたリアルタイム姿勢検出と関節角度算出、バックエンドにFastAPIでのセッション管理と評価記録、さらにOpen WebUIと知識ベースを組み合わせたリハビリ評価アシスタントを備え、ROM評価や動作指導、連続トレーニングのサポートまでをカバーします。医療診断ではなくあくまでデモ・健康管理支援を目的としています。

https://github.com/zhupcpc/Telerehabilitation----demo

概要

本リポジトリ「Telerehabilitation----demo」は、筋骨格系の遠隔リハビリテーションをローカルで試せるデモ実装です。フロントエンド（rehab-web）はReact＋ViteとMediaPipe Poseを利用し、ウェブカメラ映像から骨格検出・関節角度算出を行い、ROM（可動域）評価、動作ガイド、連続トレーニング指導を提供します。バックエンドはFastAPIでセッションのライフサイクル管理やイベント記録・指標集計を担当。さらにOpen WebUIと組み合わせた対話式の康復評価アシスタントや術後知識ベースが組み込まれ、会話による評価やトレーニング計画生成を補助します。なお本プロジェクトはあくまでデモであり医療診断・処方を目的としません。

GitHub

リポジトリの統計情報

  • スター数: 2
  • フォーク数: 0
  • ウォッチャー数: 2
  • コミット数: 4
  • ファイル数: 19
  • メインの言語: JavaScript

主な特徴

  • リアルタイム姿勢検出（MediaPipe Pose）と関節角度の算出による動作評価
  • React + Vite による軽量なフロントエンド（ブラウザベース）でカメラから直接処理
  • FastAPI によるセッション管理とイベント記録、完了率などの指標集計
  • Open WebUI と知識ベース連携による対話型の康復評価アシスタントと計画生成

技術的なポイント

このプロジェクトの技術的な核は「ブラウザベースのリアルタイム姿勢推定」と「LLM（Open WebUI）を利用した評価アシスタント」の組み合わせにあります。フロントエンドはReact＋Viteで構築され、MediaPipe Poseを利用してカメラ映像から2D／3Dの骨格点を抽出します。抽出した骨格点から関節の角度（例：肘屈曲角度）や距離を計算し、ROM（Range of Motion）や動作の正否判定、動作回数・速度といった運動指標を導出します。これらの計算はクライアント側で完結させることで低遅延なフィードバックを実現し、ユーザー体験を向上させています。

バックエンドはFastAPIで、評価セッションの生成・終了、イベント（動作完了・指摘など）の記録、指標の集計や保存を担います。API経由でフロントエンドとやり取りし、トレーニング履歴や統計データを蓄積する構成です。加えて、Open WebUI（ローカルで動かすLLMインターフェース）と化合した知識ベースを用意しており、プロンプト（評価システムの指示文）と術後リハビリ知識を組み合わせることで、対話形式での質問応答やトレーニングプラン生成が可能です。これにより単なる動作検出に留まらない「評価→説明→計画提案」の流れが作れます。

設計上はローカル展開を前提としており、プライバシー面での利点（映像や個人データをクラウドに送らない運用）がある一方、セキュリティや精度に関する課題も存在します。MediaPipeの2D検出は照明やカメラ角度に敏感であり、医学的用途に用いる場合は臨床検証や専門家監修が不可欠です。また、LLMを用いる評価アシスタントはプロンプト品質や知識ベースの整備に依存するため、誤情報防止のためのガードレール（プロンプト設計、出力検査、ログ管理）が重要です。拡張点としては、カメラ・角速度を含む複数センサー統合、顔・表情からの痛み推定、Docker化によるデプロイ自動化、認証・監査ログの強化などが考えられます。

プロジェクトの構成

主要なファイルとディレクトリ：

  • .cursor: dir
  • .gitattributes: file
  • LICENSE: file
  • Licenses.txt: file
  • OPEN_WEBUI_API_对接说明.md: file

…他 14 ファイル

（リポジトリ内には README.md、フロントエンド用の demo HTML（例：elbow-demo.html）や、各種ドキュメント、サンプル実装が含まれていることが示唆されています）

まとめ

ローカルで試せる姿勢検出×LLM連携のリハビリデモで、研究やプロトタイピングに有用。

リポジトリ情報：

READMEの抜粋：

云启熹光 · 肌肉骨骼远程康复健康平台（Demo）

本项目是一个本地可部署的肌肉骨骼远程康复健康平台 Demo，由以下部分组成：

  • 前端 rehab-web：React + Vite + MediaPipe Pose
    • 实时动作检测（摄像头 + 骨架 & 关节角度）
    • ROM 评估、动作指导、连续训练指导
    • 远程康复健康咨询（直连 Open WebUI 的康复评估助手）
  • 后端 backend：FastAPI
    • 评估会话生命周期与事件记录
    • 完成率等指标统计
  • Open WebUI + 知识库：
    • 康复评估系统提示词 + 术后康复知识库
    • 用于对话问答与训练计划生成

重要声明：本项目仅用于康复与健康管理建议演示，不构成医疗诊断或处方。