Piper is now available on the App Store! 🎉
Experience high-quality offline neural text-to-speech directly on your device.

Want to try the latest features early?
Join the TestFlight Beta 🚀

📥 Cloning & Building Piper

System Requirements

• iOS 18.0+
• macOS 13.3+
• Xcode 26+
• mise

---

Getting the Sources

git clone https://github.com/IhorShevchuk/piper-app.git
cd piper-app

---

Install Toolchain (via mise)

Piper uses mise to manage development tools.

Install mise

curl https://mise.run | sh

Then install tools:

mise install

This installs:

• Tuist
• SwiftLint

---

Generate the Xcode Project

Piper uses Tuist with Swift Package Manager for dependencies. First resolve SPM dependencies, then generate the workspace:

mise run install
mise run generate

Open the generated Piper.xcworkspace in Xcode.

open Piper.xcworkspace 

Note: Run mise run install whenever Package.swift or dependencies change. Otherwise mise run generate alone is sufficient.

Available Mise Tasks

Task	Description
mise run install	Resolve SPM dependencies (Package.swift)
mise run generate	Generate Xcode project
mise run build <number> [simulator|device]	Build from command line (for CI)
mise run lint [--fix]	Run SwiftLint

---

📱 Running the App

Simulator

1. Open the generated workspace
2. Select an iOS Simulator
3. Build & Run Piper

---

Physical Device

1. Open the generated workspace
2. Select your device
3. Configure code signing for:
   • Piper
   • PiperTTS