Foundation Models Playgrounds

This repository contains a collection of Swift playgrounds demonstrating how to interact with Apple's Foundation Models. Each playground showcases a small example or tool that highlights a specific generative capability.

✅ Free on‑device inference	✅ Privacy with no API keys to manage	✅ Offline access (zero remote latency)	✅ Maintain small app size
✅ Simple integration	✅ Structured output	✅ Tool calling for agentic use cases	✅ Will only get better over time

Playground Catalog

Chat & Conversation

1. Basic.swift – A minimal example of chatting with a helpful assistant.
2. BasicChat.swift – Shows a simple back-and-forth chat session.
3. ChatInstructions.swift – Sets instructions dynamically for each chat run.
4. CharacterChat.swift – Role-plays as a medieval knight in conversation.
5. ChainedPrompts.swift – Uses multiple model calls to build a story from a headline.
6. ConversationMemory.swift – Shows how to retrieve the transcript of a session.
7. StreamingTokens.swift – Streams individual tokens from the model.
8. ShakespeareConversation.swift – Chats in the style of Shakespeare.
9. ModelAvailability.swift – Checks the availability status of the system model.
10. DynamicTranslateOrSummary.swift – Switches between translation and summarization tools.
11. DynamicTriviaOrDarkMode.swift – Mixes a trivia score tool with the dark mode tool.

Summarization & Explanation

12. ArticleSummary.swift – Summarizes article key points in bullet form.
13. BookSeriesSummary.swift – Summarizes multiple books in a series.
14. BugReportSummarizer.swift – Summarizes a set of software bug reports into key themes.
15. CodeSummary.swift – Summarizes the purpose of a short code sample.
16. ExplainConcept.swift – Explains a technical concept in simple terms.
17. NewsSummary.swift – Summarizes news articles concisely.
18. TranscriptSummarizer.swift – Summarizes a session transcript at the end.
19. Summarize.swift – Summarizes a block of text in a few sentences.
20. StructuredBookRecommendation.swift – Suggests a book using a structured format.
21. ResumeGenerator.swift – Builds a simple resume with highlights.
22. RecipeMaker.swift – Generates a recipe based on user ingredients.
23. MedicalCase.swift – Simulates a multi-expert discussion of a patient case.
24. MathProblemSolver.swift – Solves algebra problems step by step.
25. TranscriptReview.swift – Demonstrates capturing and reviewing a transcript.
26. ProductComparison.swift – Summarizes differences between two products in a table.
27. ChatSummary.swift – Summarizes recent voice chat into bullets and action items.
28. ExpandedThought.swift – Rewrites a short answer into detailed reasoning steps.
29. MemorySummary.swift – Compresses dialog for long‑term memory storage.
30. MetadataTags.swift – Labels text with language, sentiment, and keywords.

Code Assistance

31. CodeCompletion.swift – Generates code completions given a snippet.
32. CodeRefactor.swift – Refactors code to improve clarity.
33. CodeReviewAssistant.swift – Offers feedback on Swift code to improve readability.
34. CodingChallengeGenerator.swift – Supplies short programming puzzles with hints.
35. DebuggingInstructions.swift – Guides the model to debug code step by step.
36. TestCaseGenerator.swift – Produces unit test cases from requirements.
37. JSONGenerator.swift – Produces structured JSON from a model response.
38. SQLQueryAssistant.swift – Converts natural language into SQL queries.
39. NestedGenerable.swift – Demonstrates nested generable types.
40. CodeSnippet.swift – Generates RealityKit physics code from natural language.
41. ModelEntityHelper.swift – Produces basic ModelEntity properties from a prompt.

Language & Translation

42. AutocompleteAssistant.swift – Produces text completions for short prompts.
43. FrenchTranslation.swift – Translates phrases into French.
44. EmojiTranslator.swift – Converts short sentences into strings of emojis.
45. Translate.swift – Translates text between languages.
46. LanguageFlashCard.swift – Generates flash cards for learning new words.
47. LanguageIdiomTutor.swift – Explains idioms with usage examples.
48. LanguageTriage.swift – Classifies user requests by topic.
49. SynonymFinder.swift – Lists synonyms for a given word.
50. VocabularyQuizMaker.swift – Generates multiple-choice vocabulary quizzes.

Tools & Automation

51. CalendarEventTool.swift – Demonstrates a tool that adds events to a calendar.
52. ContactLookupTool.swift – Implements a custom tool to search a contact list.
53. DarkModeTool.swift – Example tool that toggles dark mode on a device.
54. GameDifficultyTool.swift – Tool that sets a game difficulty value.
55. HealthStepsTool.swift – Records a daily step count via a tool.
56. SleepDataTool.swift – Example tool that logs sleep statistics.
57. StockPriceTool.swift – Retrieves a stock price using a tool.
58. TriviaScoreTool.swift – Maintains a trivia score via a tool.
59. DynamicWeatherOrStock.swift – Uses weather or stock quote tools depending on request.
60. DynamicSleepOrSteps.swift – Combines sleep and step tracking tools.
61. DynamicContactOrCalendar.swift – Chooses between contact or calendar tools based on intent.
62. DynamicRecipeOrWorkout.swift – Selects recipe or workout tools for each prompt.
63. NumericConversion.swift – Converts numbers between formats.
64. AssetMatch.swift – Selects the best matching USDZ asset for a prompt.
65. ColorFix.swift – Adjusts a color palette to be color‑vision‑deficiency safe.
66. MockCSV.swift – Generates synthetic CSV data for testing.
67. PoseStats.swift – Aggregates head‑pose metrics from visionOS sessions.
68. TelemetrySample.swift – Analyzes telemetry to assess cognitive load.
69. ContentTagging.swift – Generates descriptive tags for a text sample.

Planning & Productivity

70. ContentPlanner.swift – Outlines a weekly plan for social media posts based on a topic.
71. DailyMotivation.swift – Provides a quick motivational quote.
72. DailyQuote.swift – Creates an inspirational quote using a generable structure.
73. EmailComposition.swift – Generates a short email from a prompt.
74. EmailResponseDraft.swift – Drafts a concise reply to an email.
75. FashionRecommendation.swift – Suggests outfit combinations for an occasion or season.
76. FinancialStrategy.swift – Offers financial planning suggestions.
77. MarketingTagline.swift – Suggests a catchy marketing tagline.
78. GardenPlanner.swift – Plans a home garden with planting suggestions.
79. RoadTripPackingList.swift – Generates a checklist for packing on a road trip.
80. VacationPackingHelper.swift – Suggests items to pack for a vacation.
81. WorkoutPlan.swift – Creates a workout plan for the week.
82. WorkoutSchedule.swift – Produces a workout schedule with dates.
83. TravelBudgetEstimator.swift – Estimates travel costs for a trip.
84. TravelItinerary.swift – Plans a travel itinerary for a destination.
85. PitchDeckOutline.swift – Provides a structured outline for a startup pitch deck.
86. VegetarianMenu.swift – Suggests a vegetarian dinner menu.
87. MindMap.swift – Produces a mind‑map outline for a topic.
88. SlideDeck.swift – Generates a multi-slide presentation outline.

Creative & Entertainment

89. Haiku.swift – Writes a short haiku about a topic.
90. ShortStory.swift – Writes a brief fictional story.
91. NaturePoem.swift – Creates a short poem about nature.
92. StreamingPoem.swift – Streams the lines of a poem as they're generated.
93. MovieNightRecommendation.swift – Recommends a movie with a rating and reason.
94. MusicAlbum.swift – Describes a music album using a generable structure.
95. MusicRecommendation.swift – Suggests music tracks or albums based on mood.
96. NovelOutline.swift – Produces a brief outline for a novel idea.
97. SuperheroProfile.swift – Generates a profile for a fictional superhero.
98. RiddleMaker.swift – Creates a riddle for entertainment.
99. TriviaQuestionWriter.swift – Generates a trivia question with its answer.
100. SpaceMission.swift – Imagines a conversation about a space mission.
101. TechPanel.swift – Simulates a panel of experts in a tech discussion.
102. FilmProduction.swift – Provides a short film production outline.
103. TrendingTopics.swift – Lists currently trending discussion topics.
104. NewsHeadlineTool.swift – Tool that generates a headline from news text.
105. NextLeapDay.swift – Shows the date of the next leap day.
106. MoonLandingDate.swift – Retrieves the date of the first moon landing.
107. WeatherReport.swift – Generates a brief weather report.
108. ConstrainedCharacterProfile.swift – Generates a character profile with guides enforcing structure.
109. RegexCharacterName.swift – Generates a name that matches a regEx pattern.
110. ImagePrompt.swift – Creates an image-generation prompt with style cues.
111. ProceduralTexture.swift – Derives RealityKit material settings from adjectives.

Education & Learning

112. InterviewQuestionCoach.swift – Produces sample interview questions with brief answers.
113. DebateRuling.swift – Judges which side of a debate makes the stronger case.
114. SocraticGuide.swift – Generates Socratic questions to lead a learner.

Safety & Guardrails

115. GuardrailViolation.swift – Shows how guardrails handle unsafe requests.
116. DenyListCheck.swift – Checks prompts against a deny list before sending.
117. SafetyGuidedGeneration.swift – Uses guardrails to filter unsafe output.
118. SafetyInputBoundaries.swift – Adjusts prompts to keep them wholesome.
119. SafetyInstructions.swift – Provides strict safety instructions for the model.
120. DataExtractor.swift – Extracts structured data from unstructured text.
121. SentimentAnalyzer.swift – Determines the sentiment of provided text.
122. RedactedEntity.swift – Masks personal information in text.
123. LLM-as-a-Judge.swift – Evaluates answers for closeness to an expected response.
124. RefereeDecision.swift – Picks the best answer when agents disagree.

Miscellaneous Tool Demos

125. CityInfoTools.swift – Multi-tool sample for city population, area, and timezone.
126. AnimalInfoTools.swift – Multi-tool sample for animal facts, habitats, and diet.
127. PlanetInfoTools.swift – Multi-tool sample for planetary distances, gravity, and atmosphere.
128. MovieInfoTools.swift – Multi-tool sample for movie rating, director, and cast.
129. PlantCareTools.swift – Multi-tool sample for watering, sunlight, and soil needs.
130. RecipeInfoTools.swift – Multi-tool sample for ingredients, steps, and cook time.
131. CarInfoTools.swift – Multi-tool sample for price, fuel economy, and dealers.
132. ProgrammingLanguageTools.swift – Multi-tool sample for creation year, creator, and paradigm.

Agent Properties & Patterns

133. AutonomyGoal.swift – Demonstrates a self-directed loop toward a goal.
134. ReasoningPlan.swift – Breaks a task into ordered steps.
135. MemoryLoop.swift – Summarizes conversation history.
136. PerceptionObservation.swift – Extracts changes from an event log.
137. SelfReflection.swift – Uses a critic to refine an answer.
138. SafetyCompliance.swift – Applies a safety check tool.
139. ReAct.swift – Implements a reason‑act‑observe loop.
140. PlanExecute.swift – Plans once then executes sub‑tasks.
141. ReflectionLoop.swift – Refines work via a critic loop.
142. HierarchicalManager.swift – Shows manager and worker roles.
143. ReWOO.swift – Plans tool usage up front.
144. MultiAgentSimulation.swift – Simulates multiple agent roles.
145. RetrievalAugmented.swift – Uses retrieval before answering.

 Developer Docs

Foundation Models
@Generable & @Guide
Tool calling
Acceptable use requirements

 Machine Learning Research

Training details and evals
Apple Intelligence Foundation Language Models Tech Report 2025
Get started with Foundation Models adapter training

WWDC 2025 Videos

 Developer

Meet the Foundation Models framework
Deep dive into the Foundation Models framework

YouTube

Meet the Foundation Models framework
Deep dive into the Foundation Models framework