ℹ️ 🔴 我们已将该项目迁移到 Omi 仓库。当前仓库已不再维护 =>

ℹ️ 🔴 我们已将该项目迁移到 Omi 仓库。当前仓库已不再维护 =>

ℹ️ 🔴 我们已将该项目迁移到 Omi 仓库。当前仓库已不再维护 =>

OpenGlass - 开源智能眼镜

只需不到25美元的现成组件，就能把任何眼镜变成可编程的智能眼镜。记录生活、记住遇到的人、识别物体、翻译文字等等。

视频演示

想要预装版本吗？

我们将限量发售预装套件。请填写兴趣表单，以便收到通知。

社区

加入Based Hardware Discord，获取设置问题解答、贡献指南等信息。

入门指南

按照以下步骤设置 OpenGlass：

硬件

1. 准备所需组件：

   • Seeed Studio XIAO ESP32 S3 Sense
   • EEMB LP502030 3.7v 250mAH 电池
   • 3D打印眼镜支架外壳

2. 使用提供的 STL 文件打印眼镜支架外壳。

3. 打开固件文件夹，并在 Arduino IDE 中打开 .ino 文件。

   • 如果尚未安装 Arduino IDE，请从官方网站下载并安装。
   • 或者，按照固件自述文件中的步骤，使用 arduino-cli 进行构建。

4. 按照软件准备步骤，在 Arduino IDE 中为 XIAO ESP32S3 板进行设置：

   • 将 ESP32 板包添加到 Arduino IDE：
     • 导航至“文件”>“首选项”，在“附加板管理器 URL”中填入：https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
     • 导航至“工具”>“板”>“板管理器...”，在搜索框中输入关键词 esp32，选择最新版本的 esp32 并安装。
   • 选择您的板和端口：
     • 在 Arduino IDE 的顶部，选择端口（很可能是 COM3 或更高）。
     • 在左侧的开发板中搜索 xiao，然后选择 XIAO_ESP32S3。

5. 在烧录之前，请在 Arduino IDE 的“工具”下拉菜单中确保将“PSRAM:”设置为“PSRAM: OPI PSRAM”。

6. 将固件上传到 XIAO ESP32S3 板上。

软件

1. 克隆 OpenGlass 仓库并安装依赖项：

   git clone https://github.com/BasedHardware/openglass.git
   cd openglass
   npm install
   

   您也可以使用 yarn 进行安装，方法是：

   yarn install
   

2. 在位于 https://github.com/BasedHardware/OpenGlass/blob/main/sources/keys.ts 的 keys.ts 文件中添加 Groq 和 OpenAI 的 API 密钥。

3. 对于 Ollama，您可以从 https://github.com/ollama/ollama 仓库自行托管 REST API，并将该 URL 添加到 keys.ts 文件中。URL 应为 http://localhost:11434/api/chat

4. 打开终端并输入 “ollama pull moondream:1.8b-v2-fp16”

5. 启动应用程序：

   npm start
   

   如果使用 yarn，则通过以下命令启动应用：

   yarn start
   

   注意：这是一个 Expo 项目。目前，请打开本地主机链接（在完成第 5 步后会显示），以访问网页版。

许可证

本项目采用 MIT 许可证授权。

ℹ️ 🔴 我们已将该项目迁移到 Omi 仓库。当前仓库已不再维护 =>

OpenGlass 快速上手指南

⚠️ 重要提示：本项目已迁移至 Omi 仓库，当前仓库不再维护。如需最新功能和支持，请访问新仓库。以下指南基于原 OpenGlass 项目整理，供参考或复现旧版本使用。

OpenGlass 是一个开源智能眼镜项目，仅需不到 25 美元的通用组件，即可将普通眼镜改造为可黑客化的智能设备，支持生活记录、人脸记忆、物体识别、文本翻译等功能。

环境准备

硬件要求

• 开发板：Seeed Studio XIAO ESP32 S3 Sense
• 电池：EEMB LP502030 3.7v 250mAH
• 外壳：需 3D 打印支架（STL 文件见项目资源）

软件要求

• 操作系统：Windows / macOS / Linux
• IDE：Arduino IDE (推荐最新版) 或 arduino-cli
• 运行时：Node.js (建议 v16+) 和 npm/yarn
• AI 服务：
  • Groq API Key
  • OpenAI API Key
  • Ollama (本地部署，需下载 moondream:1.8b-v2-fp16 模型)

安装步骤

1. 固件烧录 (Hardware)

1. 准备 Arduino IDE：

   • 打开 IDE，进入 File > Preferences。
   • 在 "Additional Boards Manager URLs" 填入：

     https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
     

   • 进入 Tools > Board > Boards Manager，搜索 esp32 并安装最新版本。

2. 配置开发板：

   • 选择端口 (通常为 COM3 或更高)。
   • 选择开发板型号：XIAO_ESP32S3。
   • 关键设置：在 Tools 菜单中，确保 PSRAM 选项设置为 "OPI PSRAM"。

3. 上传固件：

   • 打开项目中的 firmware 文件夹，加载 .ino 文件。
   • 点击上传按钮将固件写入 XIAO ESP32S3。

2. 软件部署 (Software)

1. 克隆项目并安装依赖：

   git clone https://github.com/BasedHardware/openglass.git
   cd openglass
   npm install
   # 或者使用 yarn
   yarn install
   

2. 配置 API 密钥：

   • 编辑 sources/keys.ts 文件。
   • 填入你的 Groq 和 OpenAI API Key。
   • 若使用本地 Ollama，确保 URL 设置为 http://localhost:11434/api/chat。

3. 准备本地 AI 模型 (可选)： 如果使用 Ollama，请在终端执行以下命令拉取模型：

   ollama pull moondream:1.8b-v2-fp16
   

基本使用

1. 启动应用： 在项目根目录运行：

   npm start
   # 或者
   yarn start
   

2. 访问界面：

   • 这是一个 Expo 项目。启动后，终端会显示一个 localhost 链接。
   • 在浏览器中打开该链接即可使用 Web 版本界面。
   • 确保硬件设备已通电并连接到同一网络（如需无线通信）。

3. 功能体验：

   • 佩戴组装好的眼镜设备。
   • 通过 Web 界面查看实时画面或触发识别任务（如物体识别、文本翻译等）。

---

注：本项目采用 MIT 许可证。更多社区支持请加入 Based Hardware Discord。