C# · .NET 10 · GGUF · 本地推理

TensorSharp

本地 AI,原生 .NET。

用同一个 C# 推理引擎运行文本与多模态模型、生成图像和视频,并构建智能体工作流。通过 CLI、浏览器聊天、兼容 Ollama 与 OpenAI 的 API,或你自己的 .NET 应用使用它。

你自己的模型与硬件,本地推理无需按量计费的 API。

TensorSharp 能做什么

从第一次本地聊天,到提供模型服务、调用工具的应用。

选择你的使用方式

从适合当前任务的界面开始,三种方式都使用 TensorSharp。

终端

在本地运行模型

通过 CLI 聊天、处理多模态输入、批量任务与基准测试。首次运行指南涵盖 SDK 安装、模型下载与后端配置。

CLI 快速开始 →

浏览器与 API

为应用提供模型服务

启动服务器与 Web UI,再通过聊天、Responses 和嵌入端点连接客户端。

服务器与 Web UI 指南 →

桌面应用

使用 TensorAgent

在 Apple Silicon Mac 或 Windows x64 上安装,在应用内下载模型,开始聊天或使用工具完成任务。

下载与安装 →

选择模型与计算后端

第一次从源码运行?可从 Gemma 4 E4B 教程开始。Apple Silicon、NVIDIA、Vulkan 与 CPU 的配置见计算后端指南。模型权重需要单独下载。

发行包对应各自的发布标签,当前源码可能包含较新功能。可用下载文件与平台要求见桌面版指南。iPhone 与 iPad 通过源码构建。

实际运行效果

同一个引擎,四种用法,每张都是真实运行的原样截图。点击可查看原图。

终端中的 TensorSharp.Cli:Gemma 4 E4B 在 Metal 上的交互式聊天,读取项目 README 并回答两个问题

TensorSharp.Cli

在终端里运行模型、聊天与基准测试。

命令行 →
TensorSharp Web UI:Qwen3.8 27B 编写并运行 Python 脚本比较两种房贷,用表格和一句建议作答,并提供脚本与 CSV 下载

Web UI 聊天 · TensorSharp.Server.Host

浏览器聊天,外加兼容 Ollama 与 OpenAI 的 API。

服务器与 Web UI →
iPhone 模拟器中的 TensorAgent:Gemma 4 E2B 在应用内置的 Python 中运行脚本,把食谱从 4 人份换算为 10 人份,并以表格作答

面向 iPhone 的 TensorAgent

本地聊天与代码工具,此处展示 iPhone 模拟器。

iOS 版 TensorAgent →
Mac 上的 TensorAgent:Qwen-Image 2.1 将 TensorSharp 横幅背景改为深蓝色星空并保留文字,结果下方提供比较原图和再次编辑按钮

桌面版 TensorAgent

Qwen-Image 2.1 按指令编辑附加的图像;同一应用还支持文本聊天、文件、代码、浏览器技能与视频。

Mac 与 Windows 上的 TensorAgent →

支持的模型家族

各家族的后端、多模态输入、工具调用与验证范围不同。查看完整能力矩阵 →

面向多轮对话与并发任务

复用上下文,批量处理请求

默认启用连续批处理、分页 KV 缓存和 Radix 前缀共享。支持的模型还可选择推测解码,以进一步降低延迟。

了解服务端优化 →

发挥更多硬件的作用

部分架构支持多 GPU 层分布、张量并行和多节点执行。基于 SSD 的专家卸载可让部分大型 MoE 模型在权重超过内存容量时运行。

查看扩展支持范围 →

继续深入了解

面向开发者、研究者,以及希望理解本地推理原理的读者:从架构、API、模型卡与实测结果继续探索。

配套图书

Zhongkai Fu 所著的两本书,将 TensorSharp 源码串联为循序渐进的实现路线。

Zhongkai Fu 所著《Building LLM Inference Engines and Agentic Runtimes from Scratch: Qwen Dense and MoE Models with TensorSharp and TensorAgent》封面

Qwen · 推理与智能体

Building LLM Inference Engines and Agentic Runtimes from Scratch

Qwen Dense and MoE Models with TensorSharp and TensorAgent

以 TensorSharp 和 TensorAgent 为工程参考,使用 C# 探索从张量、分词到 Qwen 稠密与 MoE 推理的实现,再延伸至工具、技能、代码执行与沙箱边界,串联 GPU 优化、多模态输入及桌面和移动端部署。

Zhongkai Fu 所著《From Tensors to Tokens: Building a Multimodal LLM Inference Engine from Scratch with TensorSharp and Gemma 4 E4B》封面

Gemma 4 · 多模态推理

From Tensors to Tokens

Building a Multimodal LLM Inference Engine from Scratch with TensorSharp and Gemma 4 E4B

以 Gemma 4 E4B 为具体示例,使用 C# 与 .NET 构建多模态推理引擎,从张量存储、GGUF、量化和分词走向图像、视频与音频输入,并通过数值验证、缓存和批处理理解正确性与性能。

支持项目

TensorSharp 与 TensorAgent 免费提供。如果它们对你有帮助,一杯咖啡可以支持后续开发。

Buy Me A Coffee