安装

安装

hara 以 @nanhara/hara 发布,需要 Node.js 22.12 或更高版本。旧 Node 会直接给出升级 指令,不会等到依赖内部才报语法错误。独立安装包和 Hara Desktop 自带运行时。

npm i -g @nanhara/hara
hara --version

如果 Node 版本过低:

nvm install 22 && nvm use 22
npm i -g @nanhara/hara@latest

接入一个模型

hara 不是模型供应商 —— 它运行在 你自带 的模型上。这里是 个人 路径。最简单的方式是交互式配置:

hara setup

它会引导你完成三步:

1. 供应商 —— anthropic · openai · qwen,或任意 OpenAI 兼容端点(GLM、DeepSeek、本地模型……), 用 openai 再加一个 base URL。
2. API key —— 从该供应商后台获取。
3. 模型 —— 已预填合理默认值,回车即可。

更想一行搞定(或写进脚本)?

hara profile add personal --byok --provider anthropic --key sk-ant-... --model claude-opus-4-8
# 任意 OpenAI 兼容端点(GLM / DeepSeek / 本地):
hara profile add personal --byok --provider openai --base-url <url> --key sk-... --model <model>

没有 key? 免费的 通义千问(Qwen) 额度通过浏览器登录(无需绑卡 —— 你只需有一个通义千问账号):

hara login qwen

它会打开一个 chat.qwen.ai 链接;登录你自己的通义千问账号并授权(浏览器登录,不是扫码)。

要给整个团队配置 hara? 见 组织版 —— 由你所在组织运行网关,成员通过 URL 加入,无需个人 key。

首次运行

把 hara 指向一个项目,在 TUI 里直接对它说话:

cd your-project
hara                 # 交互式 REPL
# 或一次性、无界面运行:
hara -p "fix the null check in src/login.ts and run the tests"

如果哪里不对劲,hara doctor 会检查你的供应商、鉴权、模型、角色、技能和记忆。