nlux

几行代码给任意 LLM 套上可定制聊天界面

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 开发框架 🍴 复刻 85 🐛 待处理 45 👀 关注 9
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 1387
维护状态 较活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费(MIT许可证)

项目预览

nlux 项目界面预览图
图片来源:项目官网

项目数据

分类开发框架
开发团队nlkitai
定价模式🏷️完全免费
价格说明开源免费(MIT许可证)
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议NOASSERTION
主要语言TypeScript
技术栈/模型artificial-intelligence,chatbot,chatgpt,huggingface,javascript,large-language-models,llm,openai,reactjs,vercel-ai-sdk
GitHub 星标★ 1387
上线时间2023-10-29 00:00:00
代码更新2026-10-14
仓库体积19.5 MB
本站数据更新2026-10-22
维护状态较活跃
收录时间2026-10-22
浏览次数0

项目介绍

NLUX 是一个面向对话式 AI 的 JavaScript/TypeScript UI 库,帮助开发者在 React、Next.js 或原生 JS 项目中快速搭建聊天界面。它解决的核心问题是:接入不同大模型时,前端 UI 和适配层往往要重复开发。NLUX 把聊天窗口、消息流、输入框、流式输出等交互封装成组件,同时提供适配器对接 LangChain、HuggingFace、Vercel AI SDK、OpenAI 等后端,让开发者只需关注业务逻辑和模型选择。核心能力包括开箱即用的对话组件、可定制的主题与布局、流式响应渲染、多模型适配,以及对 React 和纯 JavaScript 的兼容。适合想快速给产品加上 AI 对话能力、又不想从零写聊天 UI 的团队。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-10-22 · 当前星标 ★ 1387

使用教程

⚠ 本教程由 AI 依据该项目 README 整理;原始文档不完整,部分步骤为通用流程推断,实际安装请以项目官方文档为准。

难度:入门 约 10 分钟 部署方式:库/依赖 6 步

⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。

环境要求

  • Node.js 与 npm 环境(NLUX 是 JavaScript/TypeScript 库,从 npm 安装)
  • React 或 Next.js 项目,或原生 TypeScript/JavaScript 项目
  • 已确定要对接的模型后端(OpenAI / HuggingFace / LangChain / Vercel AI SDK 等)

安装与启动步骤

  1. 1检查 Node 环境

    NLUX 是 npm 上的 JS/TS 库,先确认本机已装好 Node.js 和 npm,能在项目里执行包管理命令。

    node -v && npm -v
  2. 2安装 NLUX 包

    React 项目装 @nlux/react;纯 JS/TS 项目装核心包 @nlux/core。两者均为 README 中列出的 npm 包。

    npm install @nlux/react
  3. 3用 CLI 快速起项目

    README 提到可用 nlux-cli 快速创建 Next.js、React 或 Vanilla TypeScript 项目,节选未给出具体子命令,请查官方文档。

  4. 4在页面中使用组件

    在 React 或原生 JS 中引入 NLUX 的对话组件(聊天窗口、消息流、输入框),按文档渲染到页面。

  5. 5接入模型适配器

    README 说明提供适配器对接 LangChain、HuggingFace、Vercel AI SDK、OpenAI,按所选后端配置对应适配器。

  6. 6对照官方文档核对

    README 节选缺少完整安装与配置示例,动手前请打开官方文档确认包名版本、参数和后端接入方式。

如何确认成功

页面能渲染出 NLUX 聊天界面,输入消息后能通过适配器收到所选模型的回复即为成功(具体以官方文档示例为准)。

常见问题

Q:NLUX 支持哪些前端技术栈?

A:README 说明它面向 React 与原生 JavaScript,可用在 React、Next.js 或 Vanilla TypeScript 项目中。

Q:@nlux/react 和 @nlux/core 该装哪个?

A:React/Next.js 项目用 @nlux/react;纯 JavaScript/TypeScript 项目用核心包 @nlux/core。二者都是 README 中列出的 npm 包。

Q:怎么接入 OpenAI、HuggingFace 等模型?

A:README 提到提供适配器对接 LangChain、HuggingFace、Vercel AI SDK、OpenAI,需要为所选后端配置对应适配器,具体写法见官方文档。

Q:为什么步骤里没有写具体代码和命令?

A:README 节选只到“用 nlux-cli 快速起项目”就被截断,未给出安装命令和示例代码,为避免误导未做虚构,请以 docs.nlkit.com/nlux 为准。

Q:在哪里可以获得帮助?

A:可访问文档站点 docs.nlkit.com/nlux,或加入项目 Discord 社区提问。

注意事项

  • README 节选未包含完整安装命令,文中 npm install 为基于官方 npm 包名的通用用法,执行前请与官方文档核对。
  • nlux-cli 的具体子命令、适配器包名与版本要求均未在节选中出现,不要凭猜测填写参数。
  • 该库为前端 UI 依赖,无固定端口或服务启动方式,以你所用框架的启动命令为准。

核心亮点

  • 提供 React 组件和原生 JS API 两套用法,接入成本低
  • 内置 LangChain、HuggingFace、Vercel AI SDK 等适配器,切换模型后端改动小
  • 支持流式输出渲染和主题定制,聊天交互开箱即用

不足之处

  • 生态和文档仍在成长期,复杂定制场景示例偏少
  • 社区规模较小,遇到冷门问题可参考的讨论有限

适用场景

  • 给 SaaS 产品快速嵌入 AI 客服或助手对话窗口
  • React/Next.js 项目中对接多家大模型做统一聊天前端
  • 原型阶段用原生 JS 快速验证对话式 AI 产品形态

替代项目

assistant-ui、chatbot-ui

上一篇:sixb

下一篇:没有了!

同类项目推荐

contextual-commits 开源

让每次提交都带上决策背景,AI 帮你记录为什么

An open standard for capturing the WHY in git history

★ 154 2026-08-09
langgraph-bigtool 开源

工具上千也不怕,先检索再调用,智能体照样快准稳

Build LangGraph agents with large numbers of tools

★ 557 2026-09-25
SkillForge 开源

创建 AI 技能时,自动验证它真的能用。

A skill creator that proves its skills work. Evidence-driven skill creation for Clau···

★ 913 2026-08-10
ruby_llm-mcp 开源

用纯 Ruby 给 LLM 接上 MCP 工具,像写普通代码一样编排 AI 工作流

Full-featured MCP support for Ruby and RubyLLM—making it easy to build structured, ···

★ 269 2026-10-15
genai-quickstart-pocs 开源

照着示例跑,几分钟搭出 Bedrock 生成式 AI 演示

This repository contains sample code demonstrating various use cases leveraging Amaz···

★ 409 2026-10-19
Graphite 开源

把多个 AI 模型拖进节点图,边想边画边出结果

A private, modular node based AI workspace for thinking and creation. Seamlessly con···

★ 147 2026-08-09
agents-aea 开源

用 Python 构建能自主交易和协商的 AI 经济代理

A framework for autonomous economic agent (AEA) development

★ 242 2026-08-09
arcade-mcp 开源

写个 Python 函数,就能变成智能体可调用的工具

MCP Server Framework and Tool Development library for building custom capabilities i···

★ 1056 2026-10-13
synthora 开源

一份配置,快速搭建和评估你的 LLM 智能体

Synthora is a lightweight, extensible framework for LLM-driven agents and ALM resear···

★ 67 2026-08-09