chatgpt-android

用 Compose 快速搭建 Android 版 ChatGPT 聊天应用

这是一个基于 Jetpack Compose 构建的 Android 原生 ChatGPT 客户端示例项目，展示了如何将 OpenAI 的 Chat API 与 Stream Chat SDK 结合，打造完整的聊天机器人应用。项目解决了在 Android 端快速集成 ChatGPT 能力并实现流畅聊天界面的问题，核心能力包括消息列表展示、输入发送、流式响应处理等，同时利用 Compose 声明式 UI 简化界面开发。它不仅是可运行的 Demo，更是开发者学习现代 Android 架构、Compose 状态管理以及第三方 SDK 集成的优秀参考。

开源 free 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 3871

维护状态低维护

是否开源是

定价模式 free

项目数据

分类对话助手

开发团队skydoves

所属国家

官网地址

GitHubhttps://github.com/skydoves/chatgpt-android

定价模式free

价格说明开源项目，本地部署，使用OpenAI API需自行承担API费用，项目本身免费。

访问状态

是否开源是

开源协议Apache-2.0

主要语言Kotlin

技术栈/模型android,chat,chat-gpt,chatbot,chatbots,chatgpt,chatgpt-android,compose,jetpack,jetpackcompose,kotlin,openai-chatgpt,skydoves

GitHub 星标★ 3871

30天Star增速

HF 下载量

上线时间2022-12-09 00:00:00

最近更新2026-09-22 00:00:00

维护状态低维护

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：进阶约 30 分钟部署方式：本地安装 6 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

Android Studio 与 Android SDK（README 标注最低 API 21）
可用的 OpenAI API Key（用于调用 OpenAI Chat API）
Stream Chat 账号及其 SDK 密钥（用于聊天系统集成）
可联网的构建环境与 Android 真机/模拟器
Kotlin / Gradle 构建环境（项目为 Kotlin + Jetpack Compose）

安装与启动步骤

1克隆项目仓库

把仓库拉到本地，后续用 Android Studio 打开该目录。README 节选未给出其他安装命令。
```
git clone https://github.com/skydoves/chatgpt-android.git
```
2准备 Android 环境

安装 Android Studio 并配置 Android SDK，本项目基于 Kotlin、Jetpack Compose，最低支持 API 21。
3申请 OpenAI 密钥

在 OpenAI 平台创建 API Key，用于 README 中提到的 OpenAI Chat API 调用。
4获取 Stream 密钥

README 提到集成 Stream Chat SDK for Compose，需注册该服务并取得对应 API Key。
5写入密钥配置

把两个密钥填入项目本地配置（具体文件位置以仓库当前代码为准），切勿提交到公开仓库。
6构建并运行

用 Android Studio 打开项目，等待 Gradle 同步完成后连接真机或模拟器直接运行。

关键配置

配置项	必填	说明	示例
`OpenAI API Key`	是	调用 OpenAI Chat API 所需的密钥，填入项目本地配置	`sk-xxxxxxxx`
`Stream Chat API Key`	是	接入 Stream Chat SDK 聊天系统所需的密钥	`your_stream_api_key`

如何确认成功

README 节选未提供启动验证说明，通常以项目能在模拟器或真机上编译并正常打开为准。

常见问题

Q：README 里没有安装步骤怎么办？

A：本教程步骤基于 README 与项目信息中的通用准备动作整理；请以仓库最新 README 与源码中的密钥配置位置为准。

Q：必须同时用 OpenAI 和 Stream Chat 吗？

A：README 明确说明项目同时使用 OpenAI Chat API 与 Stream Chat SDK for Compose，两者都需准备相应密钥。

Q：支持哪些 Android 版本？

A：README 徽章标注最低 API 21，即 Android 5.0 及以上设备可运行。

Q：能编译到其他平台吗？

A：不能，这是 Android 原生客户端示例项目，需在 Android 设备或模拟器上运行。

注意事项

README 节选未包含安装命令，steps 中的非克隆步骤为通用准备动作，confidence 标记为 low。
请勿把 OpenAI 或 Stream Chat 密钥硬编码进代码并推送到公开仓库。
README 中提到的 Hilt、AppStartup、WorkManager 等仅用于说明技术栈，未给出额外配置命令。

核心亮点

完整演示了 OpenAI Chat API 与 Stream Chat SDK 的集成流程，可直接复用
基于 Jetpack Compose 构建，代码结构清晰，适合学习现代 Android UI 开发
项目活跃，星标近 4k，社区关注度高，持续更新

不足之处

依赖 Stream Chat SDK 和 OpenAI API，两者均为付费服务，长期使用成本高
示例项目未涵盖生产级功能（如用户认证、消息持久化），需自行扩展

适用场景

快速搭建 ChatGPT 风格聊天界面的 Android 原型
学习 Jetpack Compose 与第三方 SDK 集成的最佳实践
作为企业内部 AI 助手应用的初始代码库

替代项目

OpenAI-Android、ChatGPT-Android、Compose-Chat

项目介绍

chatgpt-android 是对话助手领域的开源项目，由 skydoves 开发，2022 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（3,871）位列前 30%，在对话助手分类的 905 个项目里位列前 7%。

项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-09-22。本地部署，使用OpenAI API需自行承担API费用，项目本身免费。

它主要面向的使用场景是：快速搭建ChatGPT风格聊天界面的Android原型。同类可对比的替代方案包括 OpenAI-Android、ChatGPT-Android、Compose-Chat。

上一篇：snips-nlu

下一篇：whatsapp-chatgpt