google-gemini/generative-ai-swift
Fork: 154 Star: 982 (更新于 2024-12-23 02:39:40)
license: Apache-2.0
Language: Swift .
The official Swift library for the Google Gemini API
最后发布版本: 0.5.6 ( 2024-08-23 00:19:58)
Google AI SDK for Swift
The Google AI Swift SDK is the easiest way for Swift developers to build with the Gemini API. The Gemini API gives you access to Gemini models created by Google DeepMind. Gemini models are built from the ground up to be multimodal, so you can reason seamlessly across text, images, and code.
[!CAUTION] The Google AI SDK for Swift is recommended for prototyping only. If you plan to enable billing, we strongly recommend that you use a backend SDK to access the Google AI Gemini API. You risk potentially exposing your API key to malicious actors if you embed your API key directly in your Swift app or fetch it remotely at runtime.
Get started with the Gemini API
- Go to Google AI Studio.
- Login with your Google account.
- Create an API key. Note that in Europe the free tier is not available.
- Check out this repository.
git clone https://github.com/google/generative-ai-swift
- Open and build the sample app in the
Examples
folder of this repo. - Run the app once to ensure the build script generates an empty
GenerativeAI-Info.plist
file - Paste your API key into the
API_KEY
property in theGenerativeAI-Info.plist
file. - Run the app
- For detailed instructions, try the Swift SDK tutorial on ai.google.dev.
Usage example
-
Add
generative-ai-swift
to your Xcode project using Swift Package Manager. -
Import the
GoogleGenerativeAI
module
import GoogleGenerativeAI
- Initialize the model
let model = GenerativeModel(name: "gemini-1.5-flash-latest", apiKey: "YOUR_API_KEY")
- Run a prompt
let cookieImage = UIImage(...)
let prompt = "Do these look store-bought or homemade?"
let response = try await model.generateContent(prompt, cookieImage)
For detailed instructions, you can find a quickstart for the Google AI SDK for Swift in the Google documentation.
This quickstart describes how to add your API key and the Swift package to your app, initialize the model, and then call the API to access the model. It also describes some additional use cases and features, like streaming, counting tokens, and controlling responses.
Logging
To enable additional logging in the Xcode console, including a cURL command and
raw stream response for each model request, add
-GoogleGenerativeAIDebugLogEnabled
as Arguments Passed On Launch
in the
Xcode scheme.
Command Line Tool
A command line tool is available to experiment with Gemini model requests via Xcode or the command line:
-
open Examples/GenerativeAICLI/Package.swift
- Run in Xcode and examine the console to see the options.
- Edit the scheme's
Arguments Passed On Launch
with the desired options.
Documentation
See the Gemini API Cookbook or ai.google.dev for complete documentation.
Contributing
See Contributing for more information on contributing to the Google AI SDK for Swift.
Developers who use the PaLM SDK for Swift (Decommissioned)
[!IMPORTANT] The PaLM API is now decommissioned. This means that users cannot use a PaLM model in a prompt, tune a new PaLM model, or run inference on PaLM-tuned models.
Note: This is different from the Vertex AI PaLM API, which is scheduled to be decommissioned in October 2024.
If you're using the PaLM SDK for Swift, migrate your code to the Gemini API
and update your app's generative-ai-swift
dependency to version 0.4.0
or
higher. For more information on migrating from PaLM to Gemini, see the
migration guide.
License
The contents of this repository are licensed under the Apache License, version 2.0.
最近版本更新:(数据更新于 2024-10-11 11:57:08)
2024-08-23 00:19:58 0.5.6
2024-08-02 00:26:32 0.5.5
2024-05-30 00:16:51 0.5.4
2024-05-13 22:30:51 0.5.3
2024-05-03 02:45:18 0.5.2
2024-04-30 03:08:09 0.5.1
2024-04-22 21:22:15 0.5.0
2024-04-11 06:31:45 0.4.11
2024-04-10 02:18:18 0.4.10
2024-03-29 02:55:43 0.4.9
主题(topics):
gemini, gemini-api, swift
google-gemini/generative-ai-swift同语言 Swift最近更新仓库
2024-12-21 13:48:53 argmaxinc/WhisperKit
2024-12-19 06:06:30 stripe/stripe-ios
2024-12-16 23:43:56 wordpress-mobile/WordPress-iOS
2024-12-04 20:33:05 Artificial-Pancreas/iAPS
2024-12-03 10:12:09 utmapp/UTM
2024-11-25 23:11:48 Alamofire/Alamofire