@chirag127/ai

中文文档
0.1.0发布于 2026/08/11MITES Module零依赖近 30 天下载 3483

框架-不可知的AI客户端,一个界面,两个后端. 服务器:NVIDIA NIM(OpenAI-兼容,密钥出自env NVIDIA API KEY,仅服务器侧). 客户端:Puter.js(无键,用户-auths,:免费模型). 共享聊天(消息,选择)合同.

中文使用文档
文档目录5 节
  1. 安装
  2. 服务器——NVIDIA NIM(钥匙安全)
  3. 客户端-puter.js(无钥匙)
  4. 共享
  5. 许可证

@chirag127/ai (英语)

一个AI接口,两个后端. 一样 chat(messages, opts) -> Promise<string> 合同双方.

  • ./server ——NVIDIA NIM (OpenAI-兼容). 密钥安全: 已读 NVIDIA_API_KEY 从洞. 只能靠服务器 永远不要向客户端运送.
  • ./client - 普特尔. 无密钥:用户通过Puter认证,没有密钥离开浏览器. :free 仅限模型.

框架不可知,零分解.

安装

npm i @chirag127/ai

服务器——NVIDIA NIM(钥匙安全)

隐藏的密钥 NVIDIA_API_KEY (GH 密语). 从未嵌入或发送到浏览器. 3个型号按顺序排列.

import { chat } from '@chirag127/ai/server';

// NVIDIA_API_KEY in env (or pass opts.apiKey)
const reply = await chat([{ role: 'user', content: 'Explain HMAC in one line.' }]);
console.log(reply);

// pick a model (still falls back through the rest on error)
await chat('hi', { model: 'meta/llama-3.3-70b-instruct' });

丢弃,如果 NVIDIA_API_KEY 缺少。 试验型号顺序: nvidia/llama-3.3-nemotron-super-49b-v1 → meta/llama-3.3-70b-instruct → deepseek-ai/deepseek-r1。 。 。 .

客户端-puter.js(无钥匙)

装入 js.puter.com/v2 第一次通话。 任何地方都没有密钥;用户通过Puter授权.

import { chat, listFreeModels } from '@chirag127/ai/client';

const reply = await chat('Write a haiku about caching.');
console.log(reply);

// live :free catalog
console.log(await listFreeModels());

:free 已测试的模型顺序 : nvidia/nemotron-3-super-120b-a12b:free → openai/gpt-oss-20b:free → google/gemma-4-31b-it:free。 。 。 .

共享

import { MODELS, toMessages } from '@chirag127/ai';
MODELS.server; // string[]
MODELS.client; // string[] (:free)

两个后端都接受字符串提示或 messages 数组( r){ role, content }[]) (中文(简体) ).

许可证

麻省理工学院

版本与发布记录

@chirag127/ai 共发布 1 个版本,首次发布于 2026/08/11;过去 12 个月发布了 1 个版本。

版本发布日期距今
0.1.0latest2026/08/112 个月前

关于 @chirag127/ai 的常见问题

@chirag127/ai 是什么?

框架-不可知的AI客户端,一个界面,两个后端. 服务器:NVIDIA NIM(OpenAI-兼容,密钥出自env NVIDIA API KEY,仅服务器侧). 客户端:Puter.js(无键,用户-auths,:免费模型). 共享聊天(消息,选择)合同.

如何安装 @chirag127/ai?

在项目目录运行 npm install @chirag127/ai,或使用 pnpm add / yarn add / bun add。

@chirag127/ai 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/chirag127__ai 是否存在。

@chirag127/ai 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@chirag127/ai 可以商用吗?

@chirag127/ai 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@chirag127/ai 的下载量有多少?

根据 npm 官方下载统计,@chirag127/ai 在 2026/10/10 – 2026/11/08 这 30 天内被下载 3,483 次,日均约 116 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@chirag127/ai 还在维护吗?

最新版本 0.1.0 发布于 2026/08/11(2 个月前);至今共发布 1 个版本,其中过去 12 个月发布了 1 个;首次发布于 2026/08/11。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。