環境構築

前提条件

項目	要件
OS	macOS (Sonoma / Sequoia)
Python	3.11 以上
VoiceOS	インストール済み
Slack App	Bot Token 取得済み

セットアップ手順

1. リポジトリのクローン

git clone git@github.com:aieo-product/voiceOSHackathonApp.git
cd voiceOSHackathonApp

2. Python 依存パッケージのインストール

pip install -r requirements.txt

3. 環境変数の設定

cp .env.example .env

.env を編集:

SLACK_BOT_TOKEN=xoxb-xxxx-xxxx-xxxx
SLACK_DEFAULT_CHANNEL=general

4. Slack App の作成

1. Slack API で新しい App を作成
2. OAuth & Permissions で以下の Bot Token Scopes を追加:
   • channels:history
   • channels:read
   • groups:read
   • groups:history
   • search:read
   • users:read
3. ワークスペースにインストール
4. Bot Token (xoxb-...) を .env にコピー
5. 対象チャンネルに Bot を招待: /invite @your-bot-name

5. macOS のアクセス許可

AppleScript でアプリを操作するため、以下の許可が必要:

• システム設定 → プライバシーとセキュリティ → オートメーション
  • Python（または Terminal）から Calendar / Reminders / Notes / Mail へのアクセスを許可

初回実行時にダイアログが表示されるので「OK」をクリックする。

6. 動作確認

python3 server.py

stdin/stdout で MCP プロトコルが動作することを確認。

7. VoiceOS に接続

1. VoiceOS を開く
2. パーソナライズ → カスタム連携 → 追加
3. 名前: パーソナルアシスタント
4. 起動コマンド:

python3 /path/to/voiceOSHackathonApp/server.py

8. テスト

VoiceOS で以下を話しかけて動作確認:

• 「今日やることを教えて」
• 「今日の予定を確認して」
• 「リマインダーを見せて」
• 「○○チャンネルの最新メッセージを読んで」