M1K3

M1K3 for macOS — ソースからビルド

主力のインターフェースです。Mac ネイティブの SwiftUI アプリで、オンデバイス MLX 推論、ライブ音声（Kokoro TTS + WhisperKit STT）、RAG を備えたパーソナルナレッジグラフ、組み込みエージェント、3D コンパニオン、そしてほかのエージェントから呼び出せるローカル MCP サーバーを搭載しています。

プライバシーを設計の中心に。 M1K3 はお使いの Mac で動作します。モデルは Hugging Face から一度だけダウンロードします。その後のネットワーク利用はウェブ検索のみです。回答を最新の状態に保てるよう、ウェブ検索はデフォルトで有効になっていますが、設定でスイッチを切り替えて無効にできます。（Apple Private Cloud Compute を任意で利用する段階は後のリリースで追加予定です。1.0 ビルドにはクラウド経由の処理はありません。）

要件

• Apple Silicon 搭載の macOS 26（Tahoe） — 必須です。このアプリは Liquid Glass、オンデバイス Foundation Models、MLX 経由の Metal を使用します。
• Xcode 26.x（Swift 6.2 ツールチェーン）。
• XcodeGen と（任意ですが、ログが見やすくなります） xcbeautify： brew install xcodegen xcbeautify
• ディスク容量：デフォルトのモデルにはダウンロードが不要です（Mini は Apple のオンデバイスモデルで動作します）。より大きなモデルの Lil / Big を選ぶ場合のみ、追加で約 2～7 GB の空き容量を確保してください。

ビルドと実行

git clone https://github.com/Round-Tower/M1K3.git
cd m1k3/macos

# project.yml is the source of truth — M1K3.xcodeproj is generated, not tracked
xcodegen generate

open M1K3.xcodeproj    # then ⌘R (set your own dev team for local signing)

または、コマンドラインから実行します。

xcodebuild -scheme M1K3 -destination 'platform=macOS' build | xcbeautify
# The same package graph also drives the iOS + visionOS shell (M1K3iOSApp/):
xcodebuild -scheme M1K3iOS       -destination 'generic/platform=iOS Simulator'      build | xcbeautify
xcodebuild -scheme M1K3visionOS  -destination 'generic/platform=visionOS Simulator' build | xcbeautify

初回起動時に表示されるのは 1 画面だけです。挨拶を入力すれば（名前の入力は任意です）、すぐに会話を始められます。M1K3 は Apple の組み込みオンデバイスモデルである Mini で起動するため、ダウンロードは不要です。より高性能なローカルモデル（Lil / Big）は、設定からワンクリックで利用できます。または、最初の回答後にチャット内で表示される案内から選ぶこともできます。重みは、必要なときにのみダウンロードされます。

署名に関する注意： 個人用の開発チームで実行してください。 CODE_SIGNING_ALLOWED=NO でビルドするとコンパイルは成功します（CI ではこの方法を使用します）が、アプリはサンドボックスコンテナなしで実行され、誤ったデータ保存場所を読み書きします。

テスト

ビジネスロジックは SwiftPM パッケージにあり、Xcode を使わずにテストできます。

swift test --parallel --disable-xctest   # the full fast suite (CI runs it without the flag)
tools/dev/tdd.sh M1K3KnowledgeTests     # one test target, rebuilt and run alone

テストには XCTest ではなく、swift-testing（import Testing、@Test）を使用します。

負荷の高い MLX / Metal 統合テストは、デフォルトでは環境変数で無効化されています。 M1K3_MLX_INTEGRATION=1 swift test で有効にすると、実際のモデルをダウンロードして生成を行います。Apple Silicon 専用です。

ファイル構成

M1K3App/	macOS アプリのシェル：SwiftUI ビュー、AppEnvironment、設定
M1K3iOSApp/	共通の Sources/ グラフを使用する iOS + visionOS 向け SwiftUI シェル（M1K3iOS / M1K3visionOS スキーム）
Sources/	SwiftPM モジュール：エージェント、推論、ナレッジ / RAG、音声、MCP
Tests/	モジュールごとの swift-testing テストスイート
project.yml	XcodeGen 仕様（.xcodeproj はビルド成果物です）
ROADMAP.md	今後の予定 — 最新の状態に保たれています
PLAN.md	過去のビルドログ / 意思決定記録（追記のみ、署名付き）
docs/	ADR、モデルの選定、MCP の設定、リリースパイプライン

MCP サーバー

実行中のアプリは、http://127.0.0.1:4242/mcp で HTTP 経由の MCP を提供します。ナレッジ検索、ドキュメント、音声、そして ask_m1k3（常駐 AI への質問）が利用できます。Claude Code または任意の MCP クライアントへの接続方法は、docs/MCP_SETUP.md をご覧ください。

コントリビューション

リポジトリのルートにある CONTRIBUTING.md をご覧ください。バグを見つけましたか？ アプリで 設定 → 問題を報告… を選ぶと、GitHub issue に添付できるよう、機密情報を除いた診断情報が生成されます。