Show HN: SwiftでLangGraphを構築しました
Show HN: I Built LangGraph for Swift (github.com)
要約
Swarmは、Swiftでエージェントとマルチエージェントワークフローを構築するためのフレームワークです。Swiftのコンカレンシー安全性を活用し、コンパイル時の型安全なツール呼び出し、クラッシュからの復旧、多様な基盤モデルとの連携を可能にします。宣言的なエージェント仕様やスキル定義もサポートしており、iOS/macOS開発者にとってAIエージェント構築の強力な選択肢となります。
全文翻訳
Swarm
Swiftで本番レベルのAIエージェントを構築する。
Swarmは、タイプセーフなツール、オンデバイスのApple Foundation Models、コンポーザブルなワークフロー、メモリ、ガードレール、ストリーミングを備えた、Swiftネイティブのエージェントランタイムです。同じエージェントループでiOS、macOS、Linux向けに構築できます。
[画像: Swift 6.2] [画像: Platforms] [画像: License: MIT] [画像: SPM]
はじめに · 例を見る · GitHubで⭐スターをつける
import Swarm
@Tool("Looks up a stock price")
struct PriceTool {
@Parameter("Ticker symbol") var ticker: String
func execute() async throws -> String {
"AAPL: $182.50"
}
}
let agent = try Agent(
"Answer finance questions using available tools.",
configuration: .default.name("Analyst"),
inferenceProvider: .foundationModels()
) {
PriceTool()
}
let result = try await agent.run("What is AAPL trading at?")
print(result.output)
この例では、対応デバイスでApple Foundation Modelsを使用しています。Foundation Modelsが利用できない場合は、OpenAI互換プロバイダー、Ollama、モックプロバイダー、または決定論的な例を使用してください。
インストール
Swift Package ManagerでSwarmを追加します。
dependencies: [
.package(
url: "https://github.com/christopherkarani/Swarm.git",
from: "0.6.6"
)
]
デフォルトパッケージは軽量です。コアSwarm、Foundation Models、およびマクロが含まれます。軽量版は swift-syntax(デフォルトで有効なMacrosトレイト経由)と swift-log のみを解決します。MCP Swift SDKやOpenTelemetryは解決しません。オプションのサーフェスにはトレイトを追加してください。
// Durable graph, ContextCore/Wax memory, Membrane, web helpers
.package(
url: "https://github.com/christopherkarani/Swarm.git",
from: "0.6.6",
traits: ["Integrations"]
)
// MCP server adapter (SwarmMCP + MCP Swift SDK). Also enables Macros.
.package(
url: "https://github.com/christopherkarani/Swarm.git",
from: "0.6.6",
traits: ["MCP"]
)
// OpenTelemetry wrappers (SwarmOpenTelemetry). Also enables Macros.
.package(
url: "https://github.com/christopherkarani/Swarm.git",
from: "0.6.6",
traits: ["OpenTelemetry"]
)
マクロはデフォルトで有効になっています。マクロフリービルドが必要な場合は、traits: [] を使用し、FunctionTool でツールを定義してください。トレイトを指定するとデフォルトが上書きされるため、必要に応じて組み合わせてください。例: traits: ["Integrations", "MCP", "OpenTelemetry"]。
なぜSwarmか
SwarmはSwift 6.2の厳密な並行処理を使用しているため、アクター境界を越える値はコンパイラのチェックを通過する必要があります。
Apple Foundation Modelsは、対応デバイスにオンデバイス推論パスを提供します。ローカルHTTPモデルやクラウドAPIが必要な場合、同じエージェントループでOllama、LM Studio、OpenAI互換プロバイダー、または独自のプロバイダーを使用できます。
@Tool マクロは、コンパイル時にSwift型からツールスキーマを生成します。マクロを使用しない場合は FunctionTool が利用可能です。
Workflow を使用すると、エージェントの作業をチェーン化、並列化、ルーティング、繰り返し、タイムアウトさせることができます。Job はもう一つのコンポジションツールです。これは共有のメモボックスとヘルパーで、それぞれに短い指示が与えられ、早期のステップの後に必要なヘルパーの数がわかった場合でも機能します。
| ニーズ | 使用するもの |
|---|---|
| 前のエージェントの回答を次のエージェントの入力にする | Workflow |
| 共有メモ、異なる指示、ステップ後に決定されるN個のヘルパー | Job |
アプリケーションの成長に合わせて、メモリ、ガードレール、リトライ、フォールバック、ストリーミング、トレーシング、MCP、オプションのチェックポイント/再開機能を追加できます。
ワークフローの構築
エージェントは、シーケンシャル、パラレル、ルーティングされたワークフローに構成できます。
let researcher = try Agent(
"Research the topic and extract key facts.",
inferenceProvider: .foundationModels()
)
let writer = try Agent(
"Write a concise summary from the research.",
inferenceProvider: .foundationModels()
)
let result = try await Workflow()
.step(researcher)
.step(writer)
.run("Latest advances in on-device ML")
ファンアウトとルーティングの場合:
let result = try await Workflow()
.parallel([bullAgent, bearAgent, analystAgent], merge: .structured)
.run("Evaluate Apple's Q4 earnings.")
let routed = try await Workflow()
.route { input in
input.contains("$") ? mathAgent : generalAgent
}
.run("What is 15% of $240?")
プロバイダー
すべてのエージェントは、プラグ可能な InferenceProvider を使用します。プロバイダーを変更しても、エージェントループは同じままです。プロバイダーを毎回渡したくない場合は、await Swarm.configure(provider:) でプロセス全体でデフォルトを設定できます。
| プロバイダー | 使用するタイミング |
|---|---|
| Apple Foundation Models | オンデバイス推論、.privateCloudCompute() を介したOS 27 PCC、画像添付ファイル、ネイティブプロファイルセッション、reasoningLevel を所有するループ、Transcript にシードされたSwarmプロファイル履歴、または Transcript の再水和をキャプチャしたい場合 |
| Ollama または LM Studio | 開発またはプライベートデプロイメント用のローカルHTTPモデルが必要な場合 |
| OpenAI, Azure, または OpenRouter | OpenAI互換APIを介してクラウドモデルを使用したい場合 |
| カスタムプロバイダー | 別のモデルバックエンドまたは内部サービスが必要な場合 |
let local = try Agent(
"Be helpful.",
inferenceProvider: .openAICompatible(.ollama(model: "llama3.2"))
)
設定とプライバシーの詳細については、Remote Providers を参照してください。
例
完全な例をコピーするか、APIキーやApple Intelligenceなしで決定論的なデモモードで実行してください。
| 例 | 表示内容 |
|---|---|
OnDeviceChat | ツール、ストリーミング、マルチターンの会話 |
MultiAgentPipeline | シーケンシャルおよびパラレルワークフロー、チェックポイント/再開機能 |
WaxChat | 永続的なメモリとWeb検索(Integrationsを使用) |
CodeReviewer | Swarm上に構築された小さなCLI |
cd Examples/OnDeviceChat
swift run OnDeviceChat --demo
その他の機能
| 機能 | 説明 |
|---|---|
| 会話とメモリ | Conversation を使用してマルチターンの状態を保持します。会話、スライディングウィンドウ、ベクトル、要約、またはハイブリッドメモリを選択できます。セッションはポータブルなJSONまたは FileSession ファイルにスナップショットされます。 |
| 弾力性 | バックオフと Retry-After、サーキットブレーカー、レート制限、FailoverProvider チェーン、ツールループ検出によるリトライ。 |
| ガードレール | アプリケーションに到達する前に、入力、出力、ツール引数を検証します。 |
| ストリーミング | AsyncThrowingStream を介して、ライフサイクル、ツール、思考、出力イベントを監視します。 |
| 弾力性 | プロバイダー推論のリトライ(maxAttempts は合計試行回数をカウントし、最小値は1)、サーキットブレーカー、レート制限、フォールバックチェーン。 |
| 永続的な実行 | Integrations トレイトが有効な場合、ワークフローの進行状況をチェックポイントし、プロセス再起動後に再開します。 |
| MCP | Model Context Protocolツールを発見し、ブリッジします。 |
| 可観測性 | OpenTelemetryまたはSwiftロギングを使用して、エージェントおよび推論トレースをエクスポートします。 |
要件
| プラットフォーム | 最小バージョン |
|---|---|
| Swift | 6.2+ |
| iOS / macOS / tvOS | 26.0+ |
| Linux | Ubuntu 22.04+ (Swift 6.2) |
Foundation Modelsおよび一部のプラットフォーム統合はApple専用です。Integrationsメモリ/Membraneスタックは、Linux上でポータブルCPU/ハッシュバックエンド(Metal/CoreML/MetalANNSはAppleで高速化)で構築されます。デフォルトのSwarmグラフは、UbuntuでSwift 6.2を使用してCIテストされています。Foundation Models、SwiftData、OSLog、および一部の組み込みツール動作などのApple専用機能は、Linuxでは利用できないか、異なります。OpenAI互換プロバイダーを使用するか、モックを注入するか、決定論的な例を実行してください。
デフォルトグラフのプロバイダーをグローバルに設定するには:
await Swarm.configure(provider: myProvider)
ドキュメント
| ガイド | 内容 |
|---|---|
| Getting Started | インストールと最初のエージェント |
| Why Swarm? | 設計上の選択とアーキテクチャ |
| Remote Providers | OpenAI, Azure, OpenRouter, Ollama, LM Studio |
| Secret Storage | KeychainベースのAPIキー、マスキング、チェックポイントファイルパーミッション |
| Foundation Models | キャプチャモードとネイティブセッションモード |
| Voice | 既存のエージェントをラップするターンベースの VoiceSession |
| Durable Execution | チェックポイントと再開のセマンティクス、実行検査、チェックポイントからのフォーク |
| OpenTelemetry Tracing | トレースと伝播 |
| Front-Facing API | 公開APIの概要 |
| API Catalog | 完全なシンボルリファレンス |
貢献
./scripts/ci/lean-build-test.sh
swiftformat Sources Tests --lint --config .swiftformat
すべての公開型は Sendable であることが期待されます。バグレポートと機能リクエストはGitHub Issuesに投稿してください。
Swarmがあなたの開発に役立った場合は、リポジトリにスターをつけて、何を作ったか共有してください。