yzma

Go 里直接跑本地大模型,无需 Python 和网络

开源 🏷️完全免费 ✅ 目前可打开 开发框架 🍴 复刻 28 🐛 待处理 5 👀 关注 10
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 667
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费,官网提供文档与下载入口

项目预览

yzma 项目界面预览图
图片来源:项目官网

项目数据

分类开发框架
开发团队hybridgroup
官网地址https://yzma.ai
定价模式🏷️完全免费
价格说明开源免费,官网提供文档与下载入口
访问状态✅ 目前可打开
是否开源是
开源协议NOASSERTION
主要语言Go
技术栈/模型arduino-uno-q,cuda,gguf,golang,jetson-orin-nano,llama,llamacpp,llm,metal,purego,raspberry-pi,rocm,vlm,vulkan,wasm
GitHub 星标★ 667
上线时间2025-09-21 00:00:00
代码更新2026-10-30
仓库体积2.1 MB
本站数据更新2026-11-04
维护状态活跃
收录时间2026-09-16
浏览次数1

项目介绍

yzma 是一个用 Go 语言直接封装 llama.cpp 的本地推理框架,目标是让 Go 开发者无需依赖 CGO 或外部服务,就能在应用中嵌入大语言模型和多模态模型。它通过 purego 动态加载 llama.cpp 的共享库,支持 GGUF 格式模型,并利用 CUDA、Metal、Vulkan、ROCm 等后端在 Linux、macOS、Windows 以及 WebAssembly 上实现硬件加速推理。项目覆盖从树莓派、Jetson Orin Nano 到桌面 GPU 的多种设备,适合需要把 LLM 能力直接编译进 Go 二进制、追求低延迟和离线运行的场景。核心能力包括模型加载、文本生成、视觉语言模型推理,以及跨平台构建,省去了 Python 运行时和网络调用的开销,让 Go 服务端或边缘程序可以像调用普通库一样调用本地模型。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-09-16 · 当前星标 ★ 667

技术标签

使用教程

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

环境要求

  • Go 1.21+
  • gguf 模型文件
  • CGO 编译环境

安装与启动步骤

  1. 1安装

    让 Go 程序直接调用 llama.cpp 做本地推理。

    go install github.com/hybridgroup/yzma@latest
  2. 2拉模型文件

    准备 gguf 格式模型,按显存选参数量。

  3. 3跑 hello 示例

    先跑最短示例确认绑定可用。

    go run ./examples/hello/
  4. 4跑对话示例

    传模型路径跑多轮对话。

    go run ./examples/chat/ -model ./models/qwen2.5-0.5b-instruct-fp16.gguf

如何确认成功

示例能加载模型并输出文本

注意事项

  • CGO 与本地库绑定,交叉编译要额外配置。
  • WASM 示例是另一条路径,别和本地推理混用参数。

核心亮点

  • 用 purego 动态加载 llama.cpp,避免 CGO 交叉编译地狱,Go 项目集成成本低
  • 覆盖 CUDA/Metal/Vulkan/ROCm 和 WebAssembly,同一套 API 跨桌面、边缘设备与浏览器
  • 支持 GGUF 和 VLM,能直接加载量化模型做文本与视觉推理,适合离线场景

不足之处

  • 仍处于早期阶段,API 可能随 llama.cpp 上游变动而调整
  • 文档和示例相对有限,复杂部署场景需要自行摸索

适用场景

  • Go 编写的桌面或 CLI 工具内嵌本地聊天/摘要模型,完全离线运行
  • 边缘设备如树莓派、Jetson 上跑轻量 VLM 做图像识别或语音交互
  • WebAssembly 环境中在浏览器端直接执行小模型推理,保护数据隐私

替代项目

ollama、llama.cpp、LocalAI

上一篇:MCP-Nest

下一篇:grace

同类项目推荐

sematic 开源

用纯 Python 构建可复现的 ML 流水线,一键上云

An open-source ML pipeline development platform

★ 1003 2026-08-09
superduper 开源

把 AI 模型直接跑在数据库上,快速搭建生产级智能应用。

Superduper: End-to-end framework for building custom AI applications and agents.

★ 5330 2026-08-09
tardigrade 开源

事件日志驱动,Agent 状态可回放可恢复

The TypeScript framework for building composable actors around an immutable event lo···

★ 450 2026-10-13
youtu-agent 开源

用开源模型快速搭建你的 AI 智能体,简单不简陋。

A simple yet powerful agent framework that delivers with open-source models

★ 4633 2026-08-09
VL.Fuse 开源

在节点图上拖拽,直接生成 GPU 加速的视觉程序

A library for visually programming on the GPU, built to enable rapid workflows and m···

★ 314 2026-08-09
solon-ai 开源

Java 开发者快速构建 LLM 应用,支持 RAG 与 Agent,可嵌入主流框架。

Java AI application development framework (supports LLM-tool,skill; RAG; MCP; Agent-···

★ 470 2026-08-09
eve 开源

用 TypeScript+Markdown 快速搭出可上线的 AI Agent

The Open Framework for Building Agents

★ 5787 2026-10-13
claudekit 开源

让 Claude Code 生成的代码先过验证关,再进生产环境

A verification-first engineering toolkit for Claude Code. Built for senior ICs and t···

★ 97 2026-08-09
genai-stack 开源

一条命令拉起本地大模型+图数据库的 RAG 应用

Langchain + Docker + Neo4j + Ollama

★ 5421 2026-09-12