Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/codeandtheory/ychat
A Kotlin Multiplatform library that provides access to ChatGPT and Open AI APIs
https://github.com/codeandtheory/ychat
chatgpt kmp kotlin kotlinmultiplatform multiplatform
Last synced: about 1 month ago
JSON representation
A Kotlin Multiplatform library that provides access to ChatGPT and Open AI APIs
- Host: GitHub
- URL: https://github.com/codeandtheory/ychat
- Owner: codeandtheory
- License: apache-2.0
- Created: 2023-01-18T17:39:18.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2023-12-25T10:52:38.000Z (12 months ago)
- Last Synced: 2024-05-21T15:19:53.342Z (7 months ago)
- Topics: chatgpt, kmp, kotlin, kotlinmultiplatform, multiplatform
- Language: Objective-C
- Homepage:
- Size: 271 MB
- Stars: 140
- Watchers: 7
- Forks: 10
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: CODEOWNERS
Awesome Lists containing this project
- awesome-kotlin-multiplatform - Y-Chat - Y—Chat is a Kotlin Multiplatform (KMP) project that provides a simple API for integrating the powerful ChatGPT language model developed by OpenAI into mobile applications running on multi platforms. (Libraries / Artificial Intelligence)
- awesome-list - codeandtheory/ychat - A Kotlin Multiplatform library that provides access to ChatGPT and Open AI APIs (Objective-C)
README
# Y—Chat
Y—Chat is a Kotlin Multiplatform (KMP) project that provides a simple API for integrating the powerful ChatGPT language model developed by OpenAI into mobile applications running on multi platforms. The goal of this project is to abstract all the API call logic from ChatGPT, allowing developers to easily leverage the capabilities of the language model in their mobile applications.
The repository contains the source code for the Y—Chat library, along with examples and documentation for getting started with the library. The Y—Chat library provides a consistent interface for interacting with ChatGPT, regardless of the platform, and makes it easy to generate human-like text based on a given prompt or context.
The library uses Kotlin Multiplatform to generate artifacts for both iOS, macOS, Android and JVM, allowing developers to write code once and use it on multiple platforms. The project is open source and actively maintained, with contributions from the community encouraged. Overall, Y—Chat provides a convenient and powerful way for mobile developers to incorporate the advanced natural language processing capabilities of ChatGPT into their applications.
## ⚡️ Getting Started
### iOS setup
- Go to your project’s file settings and click "Add Package":
- To add a new package, search for https://github.com/yml-org/ychat.git in the top right corner:
Once you have found the package click the "Add Package" button to add it to your project. Now you can start using the SDK in your iOS project!
See the code snippet below on how to initialize and use it one of the supported feature:
```swift
var yChat: YChat {
YChatCompanion.shared.create(apiKey: "your-api-key")
}
do {
let result = try await chatGpt.completion()
.setInput(input: "Say this is a test.")
.setMaxTokens(tokens: 1024)
.saveHistory(isSaveHistory: false)
.set... // you can set more parameters
.execute()
} catch {
// catch any error that may occurs on api call.
}
```
### Android/JVM setup
Add the following line to import the library via Gradle. First, make sure Maven Central has been added:
```kotlin
repositories {
mavenCentral()
// ...
}
```
Then, simply import the dependency to your `build.gradle` dependencies:
```kotlin
implementation("co.yml:ychat:1.4.1")
```
Take a look at the Kotlin code snippet below for an example of how to initialize and use one of the supported features:
```kotlin
val yChat by lazy {
YChat.create("your-api-key")
}
try {
val result = yChat.completion()
.setInput("Say this is a test.")
.saveHistory(false)
.setMaxTokens(1024)
.set... // you can set more parameters
.execute()
} catch (e: exception) {
// catch any error that may occurs on api call.
}
```
### Features
- [ListModels](guides/Features.md#listmodels)
- [RetrieveModel](guides/Features.md#retrieveModel)
- [Completions](guides/Features.md#completion)
- [ChatCompletions](guides/Features.md#chatcompletions)
- [ImageGenerations](guides/Features.md#imagegenerations)
- [Edits](guides/Features.md#edits)
- [AudioTranscriptions](guides/Features.md#audioTranscriptions)
- [AudioTranslations](guides/Features.md#audioTranslations)
## ℹ️ Sample apps
Take a look at our sample apps to learn how to use the SDK on different platforms:
[Android Sample](https://github.com/yml-org/ychat/tree/main/sample/android)
[iOS Sample](https://github.com/yml-org/ychat/tree/main/sample/ios)
[JVM Sample](https://github.com/yml-org/ychat/tree/main/sample/jvm)
## 🤝 Contributions
Feel free to make a suggestion or if you find any error in this project, please open an issue. Make sure to read our [contribution guidelines](https://github.com/yml-org/ychat/blob/main/CONTRIBUTING.md) before.
## 📄 License
```
Copyright 2023 YML
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```