Needle(针)是一款专为资源受限设备设计的超小型开源大模型——它仅需14MB体积、28MB运行内存,就能在智能手机、智能手表、家用传感器甚至微型机器人上完成工具调用、结构化信息提取和多步任务执行。它不依赖云端,不联网推理,却能像Gemma或FunctionGemma那样理解指令、选择工具、返回标准JSON结果,彻底打破“小设备=弱AI”的固有认知。
核心功能

● 极致轻量,开箱即用:整个模型打包为单个14MB二进制文件,无外部权重依赖,安装后零编译、零配置,首次运行自动缓存引擎,后续完全离线工作。
● 结构化输出即刻可用:输入自然语言指令(如“查今天北京天气并设闹钟7点”),直接输出带字段校验的JSON,省去正则解析、字段清洗等繁琐后处理。
● 置信度感知决策:每个响应附带经过校准的0–1置信分数,开发者可设定阈值(如0.85):高于则自动执行,低于则转人工或降级处理,大幅提升系统鲁棒性。
● 智能工具检索+动态约束:支持声明上百个API或硬件控制接口,模型每轮自动筛选最相关的5个工具,并通过字节级语法编译器实时约束生成范围,杜绝非法调用。
● 内存严格可控:采用256词元滑动窗口 + 工具KV常驻机制,全程内存占用稳定在约28MB,完美适配Android Go版、RTOS嵌入式系统及低功耗MCU协处理器。
● 本地微调友好:内置LoRA支持,仅需几行代码即可用自有设备指令微调,无需GPU——普通MacBook或树莓派即可完成个性化适配。
适合哪些人用

硬件创客可以用它给智能灯泡/温控器赋予语音指令理解能力;IoT初创公司能快速为边缘网关部署本地AI代理,避免云服务合规风险;移动App开发者可在安卓/iOS应用中嵌入离线任务引擎,实现“无网可用”的核心功能;教育工作者与学生则能基于它动手实践大模型压缩、工具学习与端侧部署全流程,真正理解AI如何“落地到指尖”。
快速上手

只需三步,30秒启动本地AI能力:
1. 安装:pip install cactus-needle
2. 定义工具(示例:控制LED):tools = [{"name": "set_led", "description": "开关LED灯", "parameters": {"state": {"type": "string", "enum": ["on", "off"]}}}]
3. 调用:from cactus_needle import Needle
model = Needle()
result = model.call("把灯打开", tools)
print(result.json()) # 输出:{"name": "set_led", "parameters": {"state": "on"}}
无需Hugging Face账号、不下载GB级模型、不写CUDA内核——真正的“pip install 就能跑”。完整文档与设备适配指南见GitHub Wiki。
项目信息
编程语言:Python|Star 数:4634|开源协议:MIT|GitHub 项目地址(https://github.com/cactus-compute/needle)
专注发现全球优质开源项目,每日精选 GitHub Trending 热门项目,提供深度中文解读,帮你快速找到最适合的开源工具与资源。 🤖 AI 工具⚡ 效率神器🎨 前端框架🛠️ 开发工具🌐 建站资源 🌐 官方网站:https://www.openklc.com/ |
夜雨聆风