mcpField
S
setup

setup

github.com/glebisセキュリティ40266 回インストール2 日前に更新
リポジトリ

setup について

confide:setup は、ローカルで動作する CONFIDE 脱識別ツールキットの一括インストールと設定を行います。confide:anon と confide:red の利用準備として依存関係と Ollama の状態を確認し、デフォルト設定を書き込みます。準備確認と設定処理でテキスト本文を読み取ったり送信したりしません。

主な機能

  1. 01依存関係とサービスの準備状況を確認
  2. 02コア依存関係を導入してモデルを取得
  3. 03デフォルト設定の書き込みとリセット
  4. 04現在の設定を表示
  5. 05準備確認では状態情報のみを出力

活用シーン

  1. 01CONFIDE ツールキットを初めて導入
  2. 02脱識別ツールの利用前に前提条件を確認
  3. 03ローカルテキスト処理の初期設定

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/glebis/claude-skills --skill setup

インストール後、Claude Code で/setupを入力して読み込まれたか確認します。

同梱ファイルscripts/setup.py

詳細

confide:setup

CONFIDE ローカル匿名化ツールキット用のワンショットインストーラーと最適なデフォルト設定の書き込みツールです。これを実行すると、追加の設定なしで confide:anon（トランスクリプトの墨消し）と confide:red（残存する再識別リスクの確認）が使えるようになります。

ローカル優先： 検出と墨消しはすべてユーザーのマシン上で実行されます。準備状況の確認と設定の書き込みで、トランスクリプトのテキストや PII を読み取ったり、表示したり、送信したりすることはありません。扱うのはブール値と設定ファイルのパスのみです。

使用するタイミング

呼び出し文の例：「confide をセットアップして」「confide をインストールして」「confide の匿名化を設定して」「confide をセットアップ」「confide で匿名化できるように準備して」。

実行方法

エントリーポイントは scripts/setup.py です。正規の DEFAULTS を参照するため、共有コア（shared/confide_core.py）をインポートします。設定をここで再定義しないでください。

  1. 準備状況を確認する（デフォルト、インストールなし）：

    python3 skills/setup/scripts/setup.py --check

    ✓／✗の表を表示します。Python の依存関係をインポートできるか（natasha、scrubadub、phonenumbers、pymorphy2）、Ollama に接続できるか（GET ollama_host/api/tags）、anon_model がダウンロード済みか、llama.cpp が PATH 上にあるか（任意）、設定ファイルが存在するかを確認します。出力はブール値のみで、PII は含まれません。

  2. すべてをインストールする（可能な限り実行し、失敗を許容）：

    python3 skills/setup/scripts/setup.py --install            # core deps + ollama pull
python3 skills/setup/scripts/setup.py --install --with-presidio   # + optional EN baseline
    • pip でインストールします：natasha scrubadub phonenumbers pymorphy2 pymorphy2-dicts-ru "setuptools<81" （setuptools<81 は pymorphy2 用の pkg_resources を提供します）。任意の presidio-analyzer は --with-presidio で指定します。
    • PATH 上に ollama がある場合は、ollama pull qwen2.5:3b を実行します。
    • 各手順で ✓／✗を報告します。手順が失敗しても、ほかの手順は中断されません。

  3. 最適なデフォルト設定を書き込む（冪等）：

    python3 skills/setup/scripts/setup.py --write-config   # writes only if absent
python3 skills/setup/scripts/setup.py --reconfigure    # overwrites with defaults
python3 skills/setup/scripts/setup.py --show           # print current config

    設定ファイルがない状態で初めて実行すると、スクリプトが自動的にデフォルト設定を書き込みます。 --write-config は、既存の（ユーザーがカスタマイズした）設定を上書きしません。強制的に初期設定に戻すには、 --reconfigure を使用してください。

設定ファイルの場所は ~/.config/confide/config.json です。

選定した最適な設定（SPEC.md に基づく）

confide_core.DEFAULTS から書き込まれます。

キー値理由
engineollama設定不要で、Metal による高速化に対応し、長いドキュメントを処理できます（長いロシア語文書では llama.cpp は 400 秒かかります）
anon_modelqwen2.5:3b準 PII 向けの高速なローカル LLM レイヤー
red_attacker_modelqwen2.5:3bローカルのデフォルトです。これは最低ラインであり、より強力な攻撃者が実際の上限です
languages["ru", "en"]バイリンガルコーパス
layers["regex", "natasha", "llm"]決定論的 → ロシア語 NER → 準 PII
redaction_styletyped_placeholder[PERSON]、[DATE] など（元に戻すためのマップはローカルに保持され、送信されません）
privacy.local_onlytrue生のテキストがマシンの外部に出ることはありません
privacy.cloud_apisfalseデフォルトではクラウドを無効にします
privacy.cloud_only_on_synthetictrue合成データまたは同意を得たデータでのみ、オプトイン時にクラウド攻撃者を使用します
ollama_hosthttp://localhost:11434ローカル Ollama

補足

  • llama.cpp は任意（再現可能なエンジン）です。存在する場合は検出して記録しますが、必須ではありません。
  • confide:red 用のより大きな攻撃者モデルは任意です。デフォルトのローカル 3b モデルではリスクが過小評価されます。
  • プログラムからの使用やテスト用に、以下の関数をインポートできます：readiness()、ensure_config(reconfigure=False)、 install(with_presidio=False)、show_config()。

コメント

Markdown 対応