https://github.com/bnpysse/erth_assistant ，请大家品鉴。😄

ERTH Assistant 🪐

License Version Architecture



ERTH Assistant 是一款拥有“极客灵魂”的跨平台桌面应用。它脱胎于《全栈极客开发图鉴》（ The Full-Stack Geek's Guide ），展示了如何通过异构双核架构与前端零 JS 约束，打造一个极速、安全的下一代个人信息管理（ PIM ）与 AI 代理中枢。



✨ 核心亮点 (Core Features)

⚡️ 异构双核架构：前端基于 ElectroBun 极速渲染，后端基于 Python Robyn 强力驱动，彻底抛弃传统重型 Electron 框架。

🛡️ 前端零 JS 宪法：完全采用 HTMX 进行局部超媒体 DOM 交互，界面由原生 HTML + Tailwind CSS 锻造，杜绝前端状态机混乱。

🧠 本地大语言模型 (LLM)：通过离线挂载 Ollama 模型，将 AI 算力留在本地，实现断网可用与极致隐私保护。

💾 分布式边缘数据库：采用 Turso (libSQL) 作为底层数据库，搭配 SQLModel 强类型约束，构建极速边缘数据流。

🪄 幽灵面板交互：注入 macOS 原生 Cocoa 框架，实现系统级全局快捷键唤醒与沉浸式毛玻璃悬浮视窗。

🧩 动态热插拔插件：系统级安全沙箱隔离，支持 Python 插件的动态挂载，业务扩展无需重新编译。

📦 全平台降维分发：利用 GitHub Actions 实现一键跨平台交叉编译（ Windows / macOS / Linux ），生成开箱即用的 .app 、.exe 与二进制包。

🚀 极速体验 (Quick Start)

如果你不想配置开发环境，可以直接前往 Releases 页面 下载对应操作系统的免安装独立包，双击即可运行。



🛠️ 开发指南 (Development)

本项目适合作为深入学习现代跨端开发架构的超级模板。



环境准备

安装 Bun 运行时 (推荐 v1.1+)

安装 UV (极速 Python 包管理器)



确保拥有 Python 3.11+ 环境

本地启动

# 1. 克隆代码库

git clone https://github.com/bnpysse/erth_assistant.git

cd erth_assistant



跨平台打包封存

我们在仓库内为您准备了跨平台的自动封存脚本：



Mac/Linux: 进入 src-app/backend ，运行 bash build_backend.sh

Windows: 进入 src-app/backend ，运行 .\build_backend.ps1

随后进入 src-app/frontend 执行 bunx electrobun build 即可完成最终的桌面端组装。



📖 关于《全栈极客开发图鉴》

本项目的架构推演、踩坑记录与设计哲学，全部完整记录于《全栈极客开发图鉴》一书中。代码库中的每个分支与 Tag ，都对应着书稿中步步为营的战术演进。



📄 许可证 (License)

本项目基于 MIT License 开源，您可以自由地使用、修改和分发。



# 2. 启动前端与主进程

cd src-app/frontend

bun install

bun run dev



# 注意：ElectroBun 的开发模式会自动拉起后端的 Python 进程，无需手动启动后端。