zeraix/zeraix

GitHub: zeraix/zeraix

Zeraix 是一个开源的本地优先 AI 桌面工作区,让用户无需云服务即可在个人电脑上运行、管理私有 AI 模型并执行 Agent 工作流。

Stars: 52 | Forks: 2

Zeraix Logo # Zeraix ### 从工作区到运行时,精心打造的本地 AI。 Zeraix 是一个开源的桌面工作区,用于在你自己的计算机上运行私有本地模型、工具、文件和 AI Agent。 除了应用程序之外,我们还不断研究现代 AI 模型如何在个人硬件上更高效地运行。**ExactFlux** 是通过这项工作开发的运行时技术,重点关注实际内存使用、持续生成速度、硬件适配和经过验证的输出正确性。 [下载](#-quick-start) · [模型系统研究](#-model-systems-research) · [当前研究](#current-research-tracks) · [开发者指南](#-developer-quick-start) [![Discord](https://img.shields.io/badge/Discord-Join%20us-5865F2?style=flat-square&logo=discord&logoColor=white)](https://discord.gg/PcQ3jr3MfH) [![X](https://img.shields.io/badge/X-@ZeraixAI-000000?style=flat-square&logo=x&logoColor=white)](https://x.com/ZeraixAI) [![License: AGPL-3.0](https://img.shields.io/badge/License-AGPL--3.0-orange?style=flat-square)](LICENSE) [![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Windows-lightgrey?style=flat-square)](#-quick-start)
Zeraix local-first AI workspace
Zeraix local model library
## Zeraix 是什么 Zeraix 的构建围绕两项相互关联的工作: ### Zeraix Desktop 人们今天就可以使用的开源应用程序: - 无需 Zeraix 账户或订阅即可运行受支持的本地模型; - 处理对话、文件、终端工具、Skills 和子 Agent; - 安装和管理 GGUF 模型及兼容的运行时; - 使用具备硬件感知能力的模型和量化建议; - 通过可选的基于 QEMU 的沙箱执行 Agent 命令; - 连接自定义的 OpenAI 兼容 endpoint 或可选的托管模型。 ### Zeraix 模型系统 我们正在进行的关于现代模型如何在消费级硬件上运行的研究: - 针对特定模型的推理优化; - 内存、存储和加速器协调; - 持续解码和尾部延迟改进; - 推测解码和多 token 预测; - 跨 MoE、稠密、多模态、长上下文及未来模型家族的架构适配; - 长请求和多轮会话的正确性验证。 目前的公开桌面版本使用 **llama.cpp** 作为其通用兼容运行时。ExactFlux 仍处于活跃研究阶段,由于它的架构、接口和验证要求仍在快速变化,因此尚未包含在公开源代码树中。**我们打算在研究达到稳定且经过充分验证的阶段后将 ExactFlux 开源。** 在此之前,我们将逐步发布进展和可复现的证据,而不会将研究原型作为正式发布的功能呈现。 ## 🚀 快速开始 只需几个步骤,即可让 Zeraix 运行本地 AI 模型。 本地核心不需要 Zeraix 账户、订阅或 API key。 ### 1. 下载 Zeraix | 平台 | 要求 | 直接下载 | |---|---|---| | 🍎 macOS | macOS 13+ · Apple Silicon | [⬇️ **下载 macOS 版本**](https://github.com/zeraix/zeraix/releases/latest/download/Mac.Zeraix.dmg) | | 🪟 Windows | Windows 10/11 · x64 | [⬇️ **下载 Windows 版本**](https://github.com/zeraix/zeraix/releases/latest/download/Win.Zeraix.exe) | 你也可以查看[最新版本说明](https://github.com/zeraix/zeraix/releases/latest)。 对于本地模型: - **建议系统内存为 16 GB 或以上**; - 一些较小的模型可以在 8 GB 内存下运行; - 更大的模型和更长的上下文需要更多内存; - 下载模型可能需要几个 GB 的磁盘空间。 ### 2. 安装并打开 Zeraix #### macOS 1. 打开已下载的 `.dmg` 文件。 2. 将 Zeraix 拖入“应用程序”文件夹。 3. 从“应用程序”中打开 Zeraix。 如果 macOS 显示安全警告,请验证安装程序是否从官方 `zeraix/zeraix` GitHub 仓库下载。 #### Windows 1. 打开已下载的 `.exe` 安装程序。 2. 选择安装目录。 3. 完成安装。 4. 启动 Zeraix。 如果 Windows 显示 SmartScreen 警告,请在继续之前验证安装程序是否从官方 `zeraix/zeraix` GitHub 仓库下载。 ### 3. 安装本地模型 1. 在 Zeraix 中打开 **Model Library**。 2. 等待 Zeraix 检查你的内存和 GPU。 3. 选择标有 **Recommended** 的模型。 4. 查看其预估的内存和存储要求。 5. 点击 **Download & Start**。 Zeraix 会自动为你的硬件选择并下载合适的 `llama.cpp` 运行时。 初始设置可能包括: - 一个 `llama.cpp` 运行时; - 一个 GGUF 模型; - 可选的视觉或推测解码模型文件; - 启用执行沙箱时的 QEMU 沙箱资源。 当模型状态变为 **Running** 时,即表示准备就绪。 ### 4. 开始你的第一次对话 1. 返回 Assistant。 2. 选择正在运行的本地模型。 3. 输入消息,例如: 选中本地模型后,模型推理将在你的计算机上运行。 ### 5. 可选:使用 Developer Mode Developer Mode 允许 Zeraix 处理由你选择的目录。 它可以: - 读取和搜索项目文件; - 创建和编辑文件; - 以 diff 形式显示更改; - 执行终端命令; - 检查命令输出; - 使用浏览器工具; - 将工作委托给专门的子 Agent。 在使用 Developer Mode 之前: - 将重要项目置于版本控制之下; - 在应用更改之前审查文件 diff; - 在批准命令之前审查它们; - 验证命令是在 QEMU 沙箱中运行还是直接在你的计算机上运行。 需要帮助?[报告 Bug](https://github.com/zeraix/zeraix/issues/new) 或加入 [Zeraix Discord](https://discord.gg/PcQ3jr3MfH)。 ## 🔬 模型系统研究 模型在不断进化。Zeraix 持续对它们在个人设备上使用内存、存储、计算和解码资源的方式进行性能分析、适配和优化。 我们的工作并不局限于单一的架构或模型家族。 ### 研究领域 | 领域 | 我们研究和优化的内容 | |---|---| | 内存系统 | 实际物理内存、统一内存、模型工作集、KV cache 和基于存储的执行 | | 运行时执行 | 针对模型的调度、数据移动、加速器利用率和稳定的长时间运行推理 | | 解码 | 持续的 token 生成、推测解码、MTP 和尾部延迟行为 | | 架构适配 | MoE、稠密、多模态、长上下文和新兴模型架构 | | 硬件适配 | Metal、CUDA、Vulkan、CPU 和不同的系统内存或 VRAM 层级 | | 模型准备 | 量化选择、运行时打包、模型资产和经过验证的设备配置文件 | | 正确性 | 相同算法比较、确定性检查、长请求和多轮稳定性 | ### 当前研究轨迹 _最后更新:2026 年 7 月_ | 模型轨迹 | 研究重点 | 当前状态 | 公开可用性 | |---|---|---|---| | Qwen3.6-35B-A3B | 低内存 MoE 执行、MTP 集成、持续解码和输出一致性 | **活跃研究中** — 内部原型设计和验证正在进行 | 尚未公开 | | Gemma 4 家族 | 工作集缩减、持续生成和尾部延迟控制 | **活跃研究中** — 内部原型设计和验证正在进行 | 尚未公开 | | 社区 GGUF 生态系统 | 硬件检测、量化选择、运行时配置和模型生命周期管理 | **已发布** | 可在 Zeraix Desktop 中使用 | 研究状态定义: | 状态 | 含义 | |---|---| | 探索中 | 结构分析和可行性实验正在进行 | | 原型 | 该方法可以运行,但尚未通过完整的验证关卡 | | 已验证 | 当前配置已通过定义的性能和正确性检查 | | 预览 | 构建版本已提供给选定的测试人员,并附有相关文档限制 | | 稳定 | 该功能已包含在受支持的公开版本中 | ### 我们衡量什么 优化不能仅凭单一的峰值速度数据来评判。根据研究轨迹的不同,我们会评估: - 实际物理内存,而不仅仅是模型文件大小; - 分别评估 prompt 处理和持续的 token 生成; - 首 token 延迟; - P95/P99 token 延迟和最大停顿; - 长输出和多轮稳定性; - 上下文增长和 KV cache 行为; - 相关情况下的存储流量和缺页错误行为; - 相同算法的输出一致性和确定性哈希; - 不同硬件和内存层级下的行为。 当某条研究轨迹仍处于不稳定状态时,我们不会在此 README 中发布针对特定模型的性能声明。一旦某条模型轨迹完成了其研究和验证关卡,它将获得一份专门的模型报告,其中包含确切的模型、量化、硬件、运行时版本、命令行、测试长度、测量方法、结果和已知限制。在此类报告发布之前,研究状态不应被解释为可复现的公开基准测试或发布保证。 ## 为什么选择 Zeraix? 大多数 AI 工作区都是围绕云 API 设计的,本地模型仅作为次要选项添加。Zeraix 的构建方式恰恰相反。 本地模型是产品的中心。对话、内存、文件、工具、Skills 和 Agent 工作流旨在你自己的计算机上运行。当你选择使用云模型时,它们仍然可用,但在本地体验中它们不是必需的。 Zeraix 还将本地推理视为一个活跃的系统问题。桌面应用程序在今天提供了一个可用的产品,而我们的模型系统研究则探索如何在人们已经拥有的硬件上运行更大、更强大的模型。 ### 本地意味着本地 - **免费的本地核心** — 无需账户、订阅或使用配额即可使用本地模型和本地 Agent 功能。 - **默认隐私** — 与本地模型一起使用的 prompt、对话和文件保留在你的设备上。 - **设置后可离线工作** — 下载所需的运行时和模型后,本地功能可以在没有 Zeraix 云服务的情况下运行。 - **自带模型** — 在本地运行受支持的 GGUF 模型或连接 OpenAI 兼容的 endpoint。 - **云是可选的** — 托管模型、账户和云文件服务是独立的可选功能。 ### 不仅仅是一个聊天客户端 Zeraix 将本地 AI 工作所需的工具组合在一个桌面应用程序中: - 本地模型安装和管理; - 硬件感知的模型推荐; - Assistant 和 Developer 模式; - 读取和编辑文件并带有 diff 预览; - 集成终端和命令执行; - 基于 QEMU 的执行沙箱; - 浏览器工具和自动化; - 持久化对话和本地内存; - Skills 和专门的子 Agent; - 可选的云模型和自定义 API endpoint。 ## ✨ 功能 ### 📦 本地模型管理 Zeraix 管理从安装到执行的本地推理工作流: - 浏览和下载受支持的 GGUF 模型; - 安装和管理本地 `llama.cpp` 运行时; - 检测系统内存、GPU 功能和可用的加速; - 根据你的硬件推荐模型和量化; - 在可用的情况下支持 Metal、CUDA、Vulkan 和面向 CPU 的运行时; - 选择单独的模型存储目录; - 启动、停止、更新和检查本地推理服务; - 通过 OpenAI 兼容的本地 endpoint 暴露正在运行的模型。 Zeraix 区分了三种模型路径: - **社区 GGUF 模型** — 来自更广泛的开放模型生态系统的兼容模型和量化。 - **Zeraix 测试的配置文件** — 由 Zeraix 团队针对特定硬件层级测试的模型、量化、上下文和运行时配置。这些配置文件并不意味着 Zeraix 训练或拥有底层模型。 - **ExactFlux 研究构建** — 正在进行内部研究的针对特定模型的推理构建。除非未来的发布另有明确说明,否则它们不属于公开版本的一部分。 模型的可用性、许可、性能和硬件要求各不相同。在使用或重新分发每个模型之前,请审查其许可证。 ### 💬 Assistant 模式 Assistant 模式专为日常本地 AI 工作而设计: - 跨受支持的模型继续对话; - 使用兼容模型分析文本文档和图像; - 在你的设备上保留本地对话和内存; - 为专门的任务添加可重用的 Skills; - 连接兼容的 MCP 服务器; - 在本地模型、自定义 endpoint 和可选的托管模型之间切换。 ### 🛠️ Developer 模式 Developer 模式赋予所选模型对工作区的受控访问权限: - 读取和搜索项目文件; - 创建和编辑文件; - 以 diff 形式预览更改; - 执行终端命令; - 检查命令输出并进行迭代; - 使用浏览器工具进行文档和应用程序测试; - 将探索、计划和审查委托给专门的子 Agent; - 在保留原始对话历史的同时压缩长上下文。 文件和命令工具的作用域限制为用户选择的工作目录。敏感操作可能需要明确批准。 ### 🛡️ 本地执行沙 Zeraix 包含一个可选的、基于 QEMU 的 Linux 环境用于 Agent 命令: - 在受支持的情况下提供硬件加速虚拟化; - 每个会话一个持久虚拟机,而不是每个命令启动一次; - 主机和客户机之间的工作区共享; - 使用 `bubblewrap` 进行逐命令的文件系统范围限制; - 捕获命令输出和执行超时; - 为本地开发服务器进行端口转发; - 适用于 macOS、Windows 和 Linux 环境的执行路径。 如果沙箱资源或硬件虚拟化不可用,根据所选的模式和当前的实现,某些操作可能会使用原生主机执行。 在批准影响重要文件的命令之前,请务必验证执行指示器。 ### 🧠 内存和上下文 - 按项目在本地存储对话; - 保留独立的 Assistant 和 Developer 工作区; - 切换模型而不丢弃对话历史; - 将可重用的内存保存为本地 Markdown 文件; - 压缩长模型上下文而不重写原始对话; - 在应用程序加密可用时,对受支持的本地对话数据进行加密。 ### 🧩 Skills 和子 Agent - 用于编码、研究、审查、写作和数据提取的内置 Skills; - 项目级别的 Skill 发现; - 用户对项目指令的控制; - 专门的探索、计划和审查子 Agent; - 面向只读和以审查为导向的 Agent 的受限工具集。 ### ☁️ 当你选择时的云服务 云功能是可选的,并与本地核心分开: - 官方托管模型访问; - OpenAI 兼容的自定义 endpoint; - 基于账户的服务; - 可选的云文件和平台功能。 当你选择托管模型或自定义 endpoint 时,prompt 和受支持的附件将发送给与该模型关联的提供商。第三方提供商可能会单独收费,并适用其自身的隐私和保留策略。 ### 🌍 多语言界面 该界面包括以下语言的翻译: - English; - 简体中文; - 繁體中文; - 日本語; - 한국어; - Français; - Español; - Italiano; - Deutsch; - Português; - 以及仓库中提供的其他变体。 ## 公开、上游和研究的边界 | 功能 | 可用 | 需要账户 | 设置后离线可用 | 实现状态 | |---|:---:|:---:|:---:|---| | Zeraix Desktop 本地核心 | ✅ | 否 | ✅ | 在此仓库中开源 | | 本地对话和内存 | ✅ | 否 | ✅ | 在此仓库中开源 | | 文件和终端 Agent 工具 | ✅ | 否 | ✅ | 在此仓库中开源 | | QEMU 执行沙箱 | ✅ | 否 | ✅ | 在此仓库中开源 | | Skills 和子 Agent | ✅ | 否 | ✅ | 在此仓库中开源 | | 自定义 OpenAI 兼容 endpoint | ✅ | 否 | 取决于 endpoint | 在此仓库中开源 | | 通用本地推理 | ✅ | 否 | ✅ | 使用独立授权的上游运行时,如 llama.cpp | | Zeraix 测试的模型配置文件 | ✅ | 否 | ✅ | 此仓库中的配置和验证层 | | ExactFlux 研究运行时 | 研究中 | 否 | 预期支持 | 目前专注于 Apple Silicon/macOS;计划在稳定和验证后开源 | | Zeraix 托管模型 | 可选 | 是 | 否 | 专有服务;仅限客户端集成 | | Zeraix 账户和云文件 | 可选 | 是 | 否 | 专有服务;仅限客户端集成 | Zeraix 不对连接自定义 endpoint 收费。Endpoint 提供商可能会对其服务收费。 ## 🔒 隐私和网络行为 ### 本地模型使用 当选择本地模型时: - 推理在你的计算机上运行; - prompt 不需要发送到 Zeraix 模型服务; - 本地对话和工作区操作保留在你的设备上。 ### 初始下载 在设置期间,某些本地功能需要网络访问: - `llama.cpp` 运行时包; - GGUF 模型文件; - QEMU 二进制文件; - Linux 沙箱镜像、内核和初始 RAM 文件系统。 安装所需的资源后,本地核心旨在无需 Zeraix 云服务的情况下运行。 ### 云和自定义 endpoint 当选择托管模型或自定义 endpoint 时,prompt 和受支持的附件将发送给该提供商。 在发送敏感信息之前,请审查提供商的条款、定价、隐私政策和保留策略。 ### Agent 权限 AI 生成的命令和文件修改可能不正确或不安全。 始终: - 审查权限请求; - 检查建议的 diff; - 验证文件路径; - 在批准之前审查命令; - 保持启用备份或版本控制。 有关漏洞报告,请参见 [Security.md](Security.md)。有关更多隐私信息,请参见 [Privacy.md](Privacy.md)。 ## 🧑‍💻 开发者快速入门 ### 要求 - Node.js 20.9 或更高版本; - Corepack; - Git; - 用于本地开发的 macOS、Windows 或 Linux。 ### 运行完整的桌面应用程序 ``` git clone https://github.com/zeraix/zeraix.git cd zeraix corepack enable pnpm install --frozen-lockfile pnpm electron:dev ``` 这将启动: - 位于 `http://localhost:3000` 的 Next.js 渲染器; - Electron 桌面进程; - Electron IPC 集成; - 本地模型、文件、终端、浏览器和沙箱功能。 使用 Electron 窗口获得完整的 Zeraix 体验。 运行本地核心不需要云凭证。一些可选的身份验证和托管服务需要额外配置。 ### 仅运行 Web 渲染器 ``` pnpm dev ``` Web 渲染器对于界面开发很有用,但它不提供完整的桌面运行时。 以下功能需要 Electron: - 本地模型管理; - Electron IPC; - 本地文件访问; - 终端执行; - 原生通知; - 浏览器自动化; - QEMU 沙箱集成。 ### 可选的环境配置 仅在你需要覆盖默认值时复制示例环境文件: ``` cp .env.example .env.local ``` 切勿提交真实的 API key、OAuth 凭证、access token、私钥或 `.env` 文件。 ### 验证你的更改 ``` pnpm typecheck pnpm lint pnpm build ``` ### 构建桌面包 ``` # macOS pnpm dist:mac # Windows pnpm dist:win ``` 桌面打包会下载平台资源,可能需要平台特定的签名和公证凭证。未签名的本地构建可能会触发操作系统的安全警告。 有关其他实现细节,请参见: - [`sandbox/qemu/README.md`](sandbox/qemu/README.md) - [`resources/bin/README.md`](resources/bin/README.md) - [`resources/README.md`](resources/README.md) ## 架构 ``` Zeraix ├── Zeraix Desktop │ ├── Next.js / React renderer │ │ ├── Assistant and Developer interfaces │ │ ├── Conversation state and context compaction │ │ ├── Skills and sub-agents │ │ └── Permission and diff views │ ├── Electron main process │ │ ├── Secure preload and IPC bridges │ │ ├── Local conversation storage │ │ ├── LLM request proxy │ │ ├── Local model and runtime management │ │ ├── File and terminal tools │ │ └── Browser automation │ ├── Execution layer │ │ ├── QEMU Linux sandbox │ │ └── Native execution path │ └── Model layer │ ├── Community GGUF models │ ├── Zeraix-tested profiles │ ├── Custom OpenAI-compatible endpoints │ └── Optional Zeraix cloud services └── Zeraix Model Systems ├── Architecture and workload profiling ├── Memory and runtime research ├── Decoding and hardware adaptation ├── Correctness and regression validation └── ExactFlux research runtime ``` 重要的源代码目录: | 路径 | 用途 | |---|---| | `src/app/agent/` | Assistant 和 Developer 应用程序页面 | | `src/app/agent/chat/` | Agent 对话 UI 和运行时循环 | | `src/lib/ai/` | 模型、内存、Skills、子 Agent 和 AI 实用程序 | | `src/components/ai/` | 模型库和 AI 界面组件 | | `electron/` | Electron 主进程和渲染器桥接 | | `electron/llm/` | 本地模型运行时管理和请求代理 | | `electron/tools/` | Agent 工具、终端集成和沙箱路由 | | `electron/tools/sandbox/` | QEMU 控制、文件系统共享和执行引擎 | | `sandbox/qemu/` | 沙箱镜像构建文件和文档 | | `scripts/` | 构建、打包和资源发布脚本 | ExactFlux 研究运行时目前不属于上述列出的公开源代码目录。我们打算在架构和验证基线足够稳定以供外部使用和贡献后将其开源。 ## 已知限制 - macOS 发布版本目前针对 Apple Silicon。 - Windows 发布版本目前针对 x64。 - ExactFlux 模型系统研究目前专注于 Apple Silicon/macOS,尚未在 Windows 上进行验证。Windows 用户不应假设当前的研究声明适用于他们的硬件。 - 本地模型质量和工具调用的可靠性取决于所选的模型。 - 性能取决于内存、GPU 支持、模型大小、量化、上下文长度和运行时配置。 - 初始模型和沙箱下载可能非常大。 - QEMU 沙箱需要硬件虚拟化和额外资源。 - 当沙箱不可用或被禁用时,某些 Agent 操作可能会使用原生执行。 - 托管服务需要网络访问,并且可能需要账户或单独付费。 - 除非发布另有明确说明,否则 ExactFlux 研究结果并非已发布的功能。 ## 故障排除 ### 没有推荐的本地模型 Zeraix 目前需要大约 8 GB 的可用内存才能运行受支持的最小本地模型。 关闭占用内存较大的应用程序,然后再次运行硬件检测。 ### 模型下载缓慢 GGUF 模型文件可能有几个 GB。下载速度取决于你的网络连接和模型主机。 请保持 Zeraix 打开状态,直到下载完成。 ### 模型无法启动 尝试以下步骤: 1. 停止模型; 2. 重启 Zeraix; 3. 打开 Model Library; 4. 重新检查本地运行时; 5. 减小上下文长度; 6. 禁用视觉; 7. 选择较小的模型; 8. 从 Model Library 检查运行时日志。 在 Windows 上,如果 GPU 运行时无法启动,Zeraix 可能会从 CUDA 回退到 Vulkan,然后再回退到 CPU。 ### Developer 模式无法执行命令 检查当前的执行模式。 如果 QEMU 沙箱不可用,请验证: - 硬件虚拟化已启用; - 沙箱资源已下载完成; - 有足够的可用磁盘空间; - 安全软件没有阻止 QEMU。 某些模式可能会提供原生执行作为回退方案。在批准命令之前,请查看执行指示器。 ### 网页不具备桌面功能 `pnpm dev` 仅启动 Web 渲染器。请使用: ``` pnpm electron:dev ``` 来运行完整的桌面应用程序。 ## 路线图 ### Zeraix Desktop - [x] 本地和云模型工作区 - [x] 带有工具调用的 Assistant 模式 - [x] 带有文件和终端的 Developer 模式 - [x] 硬件感知的模型推荐 - [x] GGUF 模型下载和 `llama.cpp` 管理 - [x] 持久化的本地对话和内存 - [x] 跨模型对话连续性 - [x] Skills 和专门的子 Agent - [x] 基于 QEMU 的执行沙箱 - [x] 针对受支持模型的多模态附件 - [ ] 扩展自动化测试和持续集成 - [ ] 改进沙箱可见性和严格的执行策略 - [ ] 添加智能的本地和云模型路由 ### Zeraix 模型系统 - [x] 建立可重复的低内存模型研究基线 - [x] 为特定模型的优化实验添加正确性关卡 - [ ] 完成对初始 Qwen3.6 和 Gemma 4 研究轨迹的验证 - [ ] 发布可复现的基准测试方法和硬件报告 - [ ] 扩展跨 Apple Silicon 内存层级的验证 - [ ] 开始 Windows 模型系统分析并建立第一个 Windows 研究基线 - [ ] 将特定模型的研究代码泛化为可重用的架构适配器 - [ ] 准备第一个 ExactFlux 研究预览 - [ ] 将研究扩展到其他架构和硬件后端 - [ ] 定期发布模型系统研究更新 路线图项目具有方向性,可能会随着模型架构、上游运行时、硬件和验证结果的演变而发生变化。 ## 贡献 欢迎提交 Bug 报告、文档改进、功能建议、翻译、模型兼容性报告、硬件结果和有针对性的代码贡献。 良好的贡献方式包括: - 在不同的硬件上测试模型; - 报告模型兼容性和性能行为; - 改进翻译和文档; - 复现已报告的 Bug; - 改进错误消息; - 添加测试; - 提交有针对性的 Bug 修复。 在提交 pull request 之前: 1. 阅读 [Contributing.md](Contributing.md)。 2. 保持每个 pull request 只专注于一个关注点。 3. 运行可用的验证命令。 4. 不要包含机密、专有代码、模型文件或 incompatible 的第三方材料。 欢迎开启 Issues、报告 Bug、建议功能、分享硬件结果和参与 Discussions。 寻找带有以下标签的 Issues: - `good first issue`; - `help wanted`; - `documentation`; - `translation`。 ## 安全 请勿通过公开的 Issues、Discussions 或 pull requests 报告安全漏洞。 请遵循 [Security.md](Security.md) 中所述的私密报告流程。 ## 开源和商业服务 此仓库包含 Zeraix Desktop 及其本地优先的应用程序运行时。 公开的本地核心可在 AGPL-3.0 的条款下免费使用。单独授权的第三方运行时、模型和下载的资源仍受其各自许可证的管辖。 ExactFlux 是一个活跃的研究运行时,目前未包含在此公开源代码树中。我们打算架构、接口和验证基线足够稳定以供外部使用和贡献后将其开源。在发布之前将明确说明确切的发布范围、时间和许可证;在研究仍不稳定期间,不承诺具体的发布日期。 Zeraix 还运营可选的专有服务,可能包括: - 账户; - 托管模型; - 云文件; - 路由; - 商业平台功能。 这些服务不是使用公开本地核心所必需的,也不属于此仓库的一部分。 ## 许可证 Zeraix Desktop 基于 [GNU Affero General Public License v3.0](LICENSE) 授权。 你可以根据该许可证的条款使用、研究、修改和重新分发此仓库中的软件。 在分发修改版本或通过网络提供修改版本以供使用时,可能需要履行 AGPL-3.0 的义务。 如果 AGPL-3.0 不适合你的商业用例,请联系 **emma@zeraix.com** 讨论商业授权。 第三方模型、运行时、库和下载的组件仍受其各自许可证的管辖。 ## 社区 - [Discord](https://discord.gg/PcQ3jr3MfH) - [X / Twitter](https://x.com/ZeraixAI) - [Bug 报告](https://github.com/zeraix/zeraix/issues/new) - [功能请求](https://github.com/zeraix/zeraix/issues/new) - 商业和合作咨询:**emma@zeraix.com**
**专为本地而构建。如果这也是你的追求,一个 ⭐ 对我们意义重大。**
标签:Vectored Exception Handling, 大模型推理, 实时告警, 开源, 本地AI, 桌面应用, 自动化攻击, 身份验证强制