wendylabsinc/wendy-swift

Swift Package Ecosystem for WendyOS

This skill maps the Swift package ecosystem for WendyOS (Linux) edge development. It provides curated recommendations organized by domain and guidance for discovering additional packages via Swift Package Index.

Curated Package Catalog

Web / HTTP Servers

| Package | Use Case | URL | Linux | |---------|----------|-----|-------------| | Hummingbird 2 | Lightweight HTTP server, routing, middleware | https://github.com/hummingbird-project/hummingbird | Full support | | Vapor | Full-featured web framework with ORM, auth, sessions | https://github.com/vapor/vapor | Full support |

Networking / SwiftNIO

| Package | Use Case | URL | Linux | |---------|----------|-----|-------------| | SwiftNIO | Event-driven networking framework, TCP/UDP | https://github.com/apple/swift-nio | Full support | | AsyncHTTPClient | HTTP/1.1 and HTTP/2 client | https://github.com/swift-server/async-http-client | Full support | | gRPC Swift 2 | gRPC client and server built on SwiftNIO and Swift Concurrency | https://github.com/grpc/grpc-swift-2 | Full support | | Swift OpenAPI Generator | Generate client/server code from OpenAPI specs | https://github.com/apple/swift-openapi-generator | Full support |

Databases

| Package | Use Case | URL | Linux | |---------|----------|-----|-------------| | PostgresNIO | Non-blocking PostgreSQL client built on SwiftNIO | https://github.com/vapor/postgres-nio | Full support | | GRDB.swift | SQLite toolkit with query builder, migrations, WAL | https://github.com/groue/GRDB.swift | Full support | | Valkey Swift | Valkey/Redis client with cluster support, pub/sub | https://github.com/valkey-io/valkey-swift | Full support |

ML / AI Inference

| Package | Use Case | URL | Linux | |---------|----------|-----|-------------| | llama.cpp | LLM inference with Swift bindings | https://github.com/ggerganov/llama.cpp | Full support (C library with Swift bindings) | | whisper.cpp | Speech-to-text inference | https://github.com/ggerganov/whisper.cpp | Full support (C library with Swift bindings) | | MLX Swift | ML framework for Apple Silicon | https://github.com/ml-explore/mlx-swift | macOS/Apple Silicon only — not available on Linux |

For llama.cpp and whisper.cpp, use the C API directly via Swift's C interop or use community Swift wrapper packages. These libraries compile natively on ARM64/AMD64 Linux.

Hardware / IoT

| Package | Use Case | URL | Linux | |---------|----------|-----|-------------| | SwiftyGPIO | GPIO, SPI, I2C, PWM, UART on Linux SBCs | https://github.com/uraimo/SwiftyGPIO | Full support (Linux only) |

Camera/video access patterns: Use Video4Linux2 (V4L2) through Swift's C interop for camera capture on Linux. For NVIDIA Jetson, use GStreamer pipelines via Process or C bindings for hardware-accelerated video.

Serial communication: Use termios via Swift's C interop for serial port access on Linux. SwiftyGPIO also provides UART support for common SBCs.

Observability

| Package | Use Case | URL | Linux | |---------|----------|-----|-------------| | swift-log | Structured logging API | https://github.com/apple/swift-log | Full support | | swift-metrics | Metrics API (counters, gauges, timers) | https://github.com/apple/swift-metrics | Full support | | swift-otel | OpenTelemetry backend for swift-log, swift-metrics, and distributed tracing | https://github.com/swift-otel/swift-otel | Full support | | swift-distributed-tracing | Distributed tracing API | https://github.com/apple/swift-distributed-tracing | Full support |

Serialization / Codable

| Package | Use Case | URL | Linux | |---------|----------|-----|-------------| | swift-protobuf | Protocol Buffers with Codable support | https://github.com/apple/swift-protobuf | Full support | | msgpack-swift | MessagePack encoder/decoder, Codable-compliant | https://github.com/fumoboy007/msgpack-swift | Full support | | Yams | YAML parser and emitter | https://github.com/jpsim/Yams | Full support |

Concurrency / Utilities

| Package | Use Case | URL | Linux | |---------|----------|-----|-------------| | swift-collections | Deque, OrderedSet, OrderedDictionary, and more | https://github.com/apple/swift-collections | Full support | | swift-algorithms | Sequence/collection algorithms (chunked, combinations, etc.) | https://github.com/apple/swift-algorithms | Full support | | swift-async-algorithms | Async sequence algorithms (merge, combineLatest, debounce, etc.) | https://github.com/apple/swift-async-algorithms | Full support | | swift-argument-parser | Type-safe command-line argument parsing | https://github.com/apple/swift-argument-parser | Full support |

Linux Compatibility Checklist

Before adding a Swift package to a WendyOS project, verify:

1. No Darwin-only imports — Check for import Darwin, import AppKit, import UIKit, import CoreFoundation (some Foundation APIs are fine on Linux, but not all)
2. Foundation compatibility — Avoid APIs that are unimplemented on Linux: FileManager works, but NSAppleScript, NSUserDefaults, Process (partially available), etc. may not
3. No Xcode build system dependencies — The package must build with swift build (SPM), not require Xcode-specific settings
4. ARM64/AMD64 CI/testing — Check if the package has Linux CI (GitHub Actions with ubuntu runners or Swift Docker images)
5. C dependencies — If the package wraps a C library, ensure that library is available on ARM64/AMD64 Linux (e.g., via apt)
6. Swift version — WendyOS uses recent Swift toolchains; confirm the package supports Swift 5.9+

Finding Packages on Swift Package Index

Swift Package Index is the community package search engine.

How to search

1. Go to https://swiftpackageindex.com and enter your search term
2. Use the Platform filter to select Linux to find Linux-compatible packages
3. Check the Compatibility Matrix on each package page — it shows which Swift versions and platforms are tested

Evaluating package quality

• Last activity — Prefer packages updated within the last 6 months
• Swift version compatibility — Should support Swift 5.9 or later
• Platform badges — Look for the Linux badge on the package page
• License — Prefer Apache 2.0 or MIT for commercial use
• SSWG status — Packages incubated by the Swift Server Work Group are production-vetted

Search URL pattern

Direct search: https://swiftpackageindex.com/search?query=YOUR_TERM

Best Practices

1. Use the curated list first — Packages listed above are vetted for Linux and WendyOS compatibility
2. Prefer SSWG packages — Swift Server Work Group packages (SwiftNIO, swift-log, async-http-client, Hummingbird, PostgresNIO) have strong Linux support guarantees
3. Watch for architecture-specific code — Swift packages compile from source, so ARM64/AMD64 works automatically unless the package contains x86-specific assembly, SIMD intrinsics, or architecture-gated #if blocks
4. Avoid Darwin-only dependencies — Even transitive dependencies can break Linux builds; use swift package show-dependencies to audit the tree
5. Pin to stable versions — Use .upToNextMajor(from:) or .upToNextMinor(from:) in Package.swift rather than branch-based dependencies
6. Fall back to Swift Package Index — If the curated list doesn't cover your need, search swiftpackageindex.com with the Linux platform filter
7. Test on Linux early — Build and run on a WendyOS device or Linux VM early to catch missing Foundation APIs and Darwin-only dependencies before they compound