项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 3324
技术标签
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- macOS 系统(Sidekick 为原生 macOS 应用)
- 安装 Xcode(开发者从源码构建时必需)
- 一个 Apple 开发者团队名称 TEAM_NAME(运行 setup.sh 时需要)
- 准备好本地 GGUF 模型或 OpenAI 兼容 API(用于对话)
安装与启动步骤
-
1查看官方安装指南
README 的 Installation 章节未给出详细步骤,只指向官网 gettingStarted 文档,请按该文档下载并安装应用。
-
2克隆项目仓库
开发者从源码构建的第一步,README 要求先克隆本仓库到本地目录。
git clone https://github.com/johnbean393/Sidekick.git -
3切换 Xcode 团队
在仓库目录下执行脚本,把 Xcode 工程中的开发团队改为你自己的 TEAM_NAME,否则无法签名运行。
./setup.sh ABCDE12345 -
4在 Xcode 中运行
打开克隆下来的项目文件,选择运行目标后点击 Run 编译启动 Sidekick。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
TEAM_NAME | 是 | 传入 setup.sh,用于替换 Xcode 项目中的开发团队 | ABCDE12345 |
如何确认成功
在 Xcode 中编译运行成功并弹出 Sidekick 主窗口,即表示部署完成。
常见问题
Q:需要联网才能使用吗?
A:不需要。README 说明所有对话都在离线状态下完成,数据保留在本机,隐私安全。
Q:还需要另外安装推理软件吗?
A:不需要。Sidekick 内置 llama.cpp 推理引擎,可直接运行 Qwen3.5 等现代 GGUF 本地模型。
Q:可以用云端模型吗?
A:可以。除本地模型外,Sidekick 也兼容 OpenAI 兼容 API,作为额外的模型选项。
Q:./setup.sh 报错或运行不起来怎么办?
A:通常是 TEAM_NAME 不正确或本机未安装 Xcode。请填写真实的 Apple 开发者团队 ID,并确认已安装 Xcode。
注意事项
- 普通用户直接按官网 gettingStarted 文档下载安装即可,无需从源码构建。
- README 未给出模型下载地址、端口或 API 密钥等具体配置命令,请以官网文档为准。
- 本地推理依赖 GGUF 格式模型,运行时通过内置 llama.cpp 后端加载。
核心亮点
- 完全本地运行,数据不出设备,隐私安全有保障
- 原生 macOS 应用,体验流畅,无需安装 Python 等环境
- 支持读取本地文件、文件夹和网页内容,回答更贴合个人数据
不足之处
- 仅支持 macOS,Windows/Linux 用户无法使用
- 本地推理对硬件要求较高,老款 Mac 可能运行缓慢
适用场景
- 隐私敏感场景:处理机密文档时,用本地 AI 避免数据外泄
- 离线办公:在无网络环境下,依然能获得 AI 辅助
- 个人知识管理:让 AI 基于本地笔记、PDF 等文件回答问题
替代项目
Ollama、LM Studio、Jan
上一篇:ChatFiles
下一篇:telegram-bot-sdk
同类项目推荐
LibreChat
开源
自建多模型 AI 聊天台,一个界面切换所有大模型
Enhanced ChatGPT Clone: Features Agents, MCP, Skills, DeepSeek, Anthropic, AWS, Open···
在终端里跟 ChatGPT 聊天,还带长期记忆
ChatGPT Bot in CLI with long term memory support using Embeddings.
HyperNerd
开源
直播聊天自动巡逻,违规秒封,主播省心。
Total Surveillance Automatic Ban Machine for Twitch and Discord
rasa-addons
开源
给 Rasa 装上增强包,拼写纠错、情感分析一步到位
A set of components to be used with Botfront and/or Rasa
chatgpt-plugin
开源
给云崽机器人装上 ChatGPT 大脑,QQ 秒变智能助手
云崽系机器人的智能聊天插件
AmigaGPT
开源
让 Amiga 老电脑也能聊 ChatGPT 和画图
AmigaOS 3.1/4.1 and MorphOS application for chatting with ChatGPT or generating imag···
awesome-chatgpt-project
开源
从注册到玩转ChatGPT,一站式中文资源合集
1.chatGPT注册 2.chatGPT成品项目整理 3.高效使用chatGPT的小技巧 ↓演示网站
tmuxai
开源
在 tmux 里随时唤起 AI,不打断终端工作流
AI-Powered, Non-Intrusive Terminal Assistant
TTG
开源
输入仓库地址,几秒内和任意 GitHub 代码库对话
Chat with any public GitHub repository within seconds!
