LLMesh

Secure LLM Mesh over MCP — v3.1.0

産業 IoT、重要インフラ、先端 AI/量子、RTOS マイコンまでを統一フレームワークで カバーする Python 統合プラットフォーム。 ローカル LLM（Ollama / llama.cpp）とクラウド LLM（OpenAI / Azure / Anthropic / OpenRouter / Groq / Together / Mistral / DeepSeek）を同一 ABC で 透過運用。117 章 / 500+ 要件項目、Rust 拡張で性能 6×、2300+ テスト全 PASS。 全体 OWASP 静的監査クリーン（shell=True / pickle / eval / SQL 注入 / 弱暗号 ゼロ、全 HTTP クライアントにレスポンスサイズ上限）、 v3.0.0 から SemVer 正式適用（docs/API_STABILITY.md の公開シンボル一覧が契約）。

Quick Start

pip install -e ".[dev]"
pytest

主要 optional extras:

pip install -e ".[industrial]"   # MTEngine / SPC / Modbus / OPC-UA / MQTT
pip install -e ".[vision]"       # ImageFirewall / VLM 経路
pip install -e ".[presidio]"     # Layer 1.5 PII 検出（v2.13.0+）
pip install -e ".[rag]"          # RAG（ベクトル検索）（v2.13.0+）
pip install -e ".[email,udp,ssh,ftp,mgmt,can,bacnet]"

Components

Core

RAG (v2.13.0+)

Protocols (multi-protocol gateway)

Industrial (v1.3.0+)

Reliability Protocol

ストリーミング通信の信頼性を MessageAssembler と ChunkSender の 組み合わせで保証する。

[正常完了]  受信: pop_completed() → STREAM_ACK 送信
            送信: handle_ack()    → 送信バッファ破棄

[欠落検出]  受信: check_timeouts() → RETRANSMIT 送信（1 回のみ）
            送信: handle_retransmit() → 欠落チャンクのみ再送

[切断検出]  受信: check_watchdog()  → True で切断シグナル
            送信: expire_old()      → TTL 超過バッファ自動破棄

Privacy Pipeline

prompt → PromptFirewall (L0/L1/L1.5/L2) → PrivacySummarizer →
         LLM Backend (Ollama / LlamaCpp) → OutputValidator → caller

Security Guardrails

• shell=True, pickle, yaml.load(unsafe), eval, exec を一切使わない
• Firewall は fail-closed（例外 → L4/BLOCK）
• OutputValidator が non-JSON / schema 不一致 / nonce replay を拒否
• subprocess 呼び出しは list 形式のみ
• すべての optional 依存は extras（軽量本体）

Performance

CLI

python -m llmesh.cli.doctor   # 環境健全性チェック
python -m llmesh.cli.status   # ランタイム状態
python -m llmesh.cli.sbom     # CycloneDX SBOM 自動生成

Documentation

概要 / 計画

• docs/ROADMAP.md — リリース計画 / バージョン履歴
• docs/REQUIREMENTS.md — 117 章 / 500+ 要件、Volume A〜N
• docs/CHANGELOG.md — 詳細変更履歴

アーキテクチャ / 仕様

• docs/ARCHITECTURE.md — アーキテクチャ
• docs/SPECIFICATION.md — API 仕様
• docs/SECURITY.md — STRIDE 脅威モデル + セキュリティ不変条件
• docs/API_STABILITY.md — Public/Internal API 境界 + SemVer ポリシー（v2.15+）
• docs/PERFORMANCE.md — モジュール別計算量 + メモリ + 推奨パラメータ（v2.15+）

利用ガイド

• docs/SETUP.md / docs/SETUP_GUIDE.md — セットアップ
• docs/USAGE.md — 使用例（v2.13/2.14 強化機能セクション含む）
• docs/INDUSTRIAL_GUIDE.md — 産業 IoT 利用ガイド（Phase A〜v3 含む）
• docs/PEERING.md / docs/PLATFORMS.md — ピアリング / プラットフォーム

運用 / トラブルシューティング（v2.18+）

• docs/DEPLOYMENT.md — Docker / systemd / k8s / シークレット管理
• docs/OBSERVABILITY.md — Prometheus / OTel / AuditTrace / SLO
• docs/TROUBLESHOOTING.md — エラー対処集 + FAQ
• docs/MIGRATION.md — バージョン間移行ガイド

開発者向け（v2.18+）

• CONTRIBUTING.md — 貢献ガイド（コミット規約 / PR チェックリスト）
• docs/DEVELOPMENT.md — 開発環境 / 内部構造 / 新規モジュール追加手順
• docs/TESTING.md — テスト戦略 / Hypothesis / カバレッジ目標
• docs/GLOSSARY.md — 用語集（LLM / セキュリティ / 産業）
• docs/SETUP.md / docs/SETUP_GUIDE.md — セットアップ
• docs/USAGE.md — 使用例
• docs/PEERING.md / docs/PLATFORMS.md — ピアリング / プラットフォーム
• docs/papers/ — RAD（21 分野コーパス）+ 論文素材