cactus

让手机和机器人秒级跑起 AI 模型,省电又流畅

cactus 是一个专为移动设备、可穿戴设备、智能家居和机器人等边缘场景设计的轻量级 AI 推理引擎。它解决了在资源受限的硬件上高效运行深度学习模型的问题,核心能力包括模型量化、内核优化、运行时管理和推理加速。项目采用 C++ 实现,提供从模型压缩到端侧部署的全链路支持,尤其擅长处理低功耗、低内存环境下的实时推理任务。通过自定义量化方案和针对 ARM 等架构优化的内核,cactus 能在保持模型精度的同时显著提升推理速度,降低能耗。其设计强调模块化和可移植性,便于开发者集成到各类嵌入式系统中,是边缘 AI 落地的高性能基础组件。

开源 free 搜索知识
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 6045
维护状态 较活跃
是否开源
定价模式 free

项目数据

分类搜索知识
开发团队cactus-compute
所属国家
定价模式free
价格说明开源项目,无在线服务,需自行部署,完全免费。
访问状态
是否开源
开源协议NOASSERTION
主要语言C++
技术栈/模型ai,android,arm,edge,edge-ai,framework,ios,llamacpp,llm,llm-inference,llms,mobile,mobile-inference,on-device-ai,quantiz,rag,smartphone,speech,transformer,whisper
GitHub 星标★ 6045
30天Star增速
HF 下载量
上线时间2025-04-23 00:00:00
最近更新2026-09-22 00:00:00
维护状态较活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数3

使用教程

难度:入门 约 5 分钟 部署方式:命令行工具 3 步

环境要求

  • macOS 系统(README 的 Quick Demo 仅演示 Mac)
  • 已安装 Homebrew(使用 brew install 命令的前提)
  • 可访问 GitHub / Homebrew 仓库的网络环境
  • 如需自行集成引擎:C++ 编译环境

安装与启动步骤

  1. 1安装 Cactus CLI

    通过 Homebrew 的 tap 直接安装 cactus-compute 提供的 cactus 命令行工具,安装完成后可在终端直接调用。

    brew install cactus-compute/cactus/cactus
  2. 2启动 Cactus

    安装完成后执行 cactus run 启动引擎。README 未说明该命令的具体参数,按其默认交互方式使用即可。

    cactus run
  3. 3用 C++ 接入引擎

    在 C++ 项目中引入 cactus_engine.h,调用 cactus_init 加载权重目录(可传 txt 目录开启 auto-rag),再用 cactus_complete 传入 JSON 消息与生成参数。

    #include "cactus_engine.h"
    
    cactus_model_t model = cactus_init(
        "path/to/weight/folder",
        "path to txt or dir of txts for auto-rag",
        false
    );

关键配置

配置项必填说明示例
path/to/weight/foldercactus_init 第一个参数,指向模型权重所在文件夹/your/path/to/weight/folder
auto-rag 文本路径cactus_init 第二个参数,单个 txt 文件或 txt 目录,用于自动 RAG/your/path/to/txts
max_tokens生成选项,限制单次回复的最大 token 数50
stop_sequences生成选项,命中列表中任意字符串时停止生成["<|im_end|>"]

如何确认成功

执行 cactus run 后能正常进入引擎交互并返回结果,即表示 CLI 安装与运行成功。

常见问题

Q:支持 Windows 或 Linux 吗?

A:README 的 Quick Demo 只给出 Mac 的安装方式(brew install + cactus run),其他系统的安装方法未在 README 中说明,请以官网 cactuscompute.com 为准。

Q:模型权重从哪里下载?

A:README 未提供权重下载地址,cactus_init 只要求传入本地的权重文件夹路径,权重获取方式需参考官网或仓库其他文档。

Q:brew install 报找不到 formula 怎么办?

A:该命令使用 tap 形式 cactus-compute/cactus/cactus,需保证本地已安装 Homebrew 且网络可访问 GitHub;可先确认 brew 命令本身可用再重试。

注意事项

  • README 的快速演示只覆盖 macOS,其他平台未给出官方安装步骤。
  • C++ 示例中的权重路径、auto-rag 路径需替换成自己机器上的真实路径。
  • README 节选未说明 cactus run 的可用参数与端口,请勿自行假定。

核心亮点

  • 专为边缘设备优化,推理速度提升明显,内存占用低
  • 提供灵活的量化工具,支持多种精度,平衡精度与性能
  • 代码结构清晰,模块化设计,易于集成到嵌入式项目

不足之处

  • 文档相对简略,上手需要一定 C++ 和底层知识
  • 社区生态尚在成长,第三方模型和工具支持有限

适用场景

  • 在智能家居设备上离线运行语音识别或图像分类模型
  • 为机器人提供实时目标检测和避障推理能力
  • 在可穿戴设备上实现健康监测数据的本地 AI 分析

替代项目

TensorFlow Lite、ONNX Runtime、ncnn

项目介绍

cactus 是基础设施领域的开源项目,由 cactus-compute 开发,2025 年首次发布。

在全站 13,014 个收录项目中,它的 GitHub 星标数(6,045)位列前 8%,在基础设施分类的 1,130 个项目里位列前 11%。

近 41 天,它的 GitHub 星标从 5,719 增加到 6,045,净增 326。

项目保持着较活跃的维护节奏,最近一次代码更新于 2026-09-22。无在线服务,需自行部署,完全免费。

它主要面向的使用场景是:在智能家居设备上离线运行语音识别或图像分类模型。同类可对比的替代方案包括 TensorFlow Lite、ONNX Runtime、ncnn。

上一篇:helix-db

下一篇:llm-graph-builder

同类项目推荐

freebuff-proxy 开源

聚合多账号,一键接入 OpenAI 兼容 API,轻松管理会话。

Multi-account OpenAI-compatible gateway for coding models. Pooled keys, session life···

★ 213 2026-08-20
microduck 开源

用 Rust 造一只会走路的桌面小鸭,快速上手双足机器人。

A Tiny biped duck robot

★ 8684 2026-09-10
soperator 开源

用 Kubernetes 原生方式运行 Slurm,简化 HPC 集群管理。

Run Slurm in Kubernetes

★ 439 2026-08-10
ollama 开源

一条命令本地跑起大模型,免费、私密、不卡顿

Get up and running with Kimi, GLM, MiniMax, DeepSeek, gpt-oss, Qwen, Gemma and other···

★ 181484 2026-08-09