项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-13 · 当前星标 ★ 3193
使用教程
⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。
环境要求
- 获取 fuxi 可执行文件(README 说明其为单个静态二进制,无运行时依赖)
- 一个 OpenAI 兼容的模型服务(base_url + api_key + model),或使用 FuXi 账号登录
- 建议安装 git 与 ripgrep,供 fuxi doctor 自检使用
- 可正常交互的终端环境,用于运行 TUI
安装与启动步骤
-
1安装 fuxi
README 的 Install 小节未给出具体安装命令,仅说明 FuXi 是单个静态二进制;请从官网或仓库获取后放到 PATH 中。
-
2验证版本
运行版本命令,确认 fuxi 已在 PATH 中且可执行。
fuxi --version -
3环境自检
检查配置、API key、git、ripgrep 等环境项是否就绪。
fuxi doctor -
4登录账号(可选)
会打开浏览器登录 FuXi 账号,自动配置官方托管模型,无需自备 API key。
fuxi login -
5生成配置模板
在 ~/.fuxi/ 生成起始 config.yaml,并自动从已设置的环境变量中探测 provider。
fuxi init -
6交互式向导(可选)
选择 provider、填入 base URL 与 key、选择模型并测试连接。
fuxi wizard -
7启动 TUI
进入终端交互界面,首次运行会在 ~/.fuxi/ 下创建配置目录。
fuxi
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
provider | 是 | 指定模型供应商标识,示例为 OpenAI 兼容类型。 | openapi |
base_url | 是 | OpenAI 兼容服务的接口地址。 | https://your-endpoint/v1 |
api_key | 是 | 服务密钥,也可改用环境变量 FUXI_API_KEY 提供。 | sk-xxxxxxxx |
model | 是 | 要使用的模型名称。 | your-model |
FUXI_CONFIG_DIR | 否 | 覆盖配置目录,默认是 ~/.fuxi。 | /your/path/.fuxi |
如何确认成功
fuxi --version 有版本输出,fuxi doctor 各检查项通过,fuxi 能进入 TUI 并正常对话。
常见问题
Q:没有 API key 能用吗?
A:可以。执行 fuxi login 打开浏览器登录 FuXi 账号,会自动provision FuXi 托管模型,无需 API key。
Q:配置文件放哪里,改完要重启吗?
A:默认在 ~/.fuxi/config.yaml,可用 FUXI_CONFIG_DIR 改目录;FuXi 运行中修改会热重载。
Q:环境变量和配置文件哪个优先?
A:优先级为:环境变量 > config.yaml > 内置默认值。
Q:想管理多个 provider 和模型怎么办?
A:使用分层写法:providers 目录加 model 选择层,可为每个模型单独设置参数。
Q:怎么切换模型和改设置?
A:在 TUI 内用 /model 切换模型,用 /config 管理权限、hooks、skills、plugins 等设置。
注意事项
- README 的 Install 小节未给出具体安装命令,实际下载方式请以官网或仓库最新说明为准。
- 配置优先级为环境变量 > config.yaml > 内置默认值。
- 设置 NO_UPDATE_NOTIFIER=1 可关闭后台更新检查提示,FUXI_DEBUG=1 开启调试日志。
- FuXi 为单个静态二进制、无运行时依赖,但仍需自备 OpenAI 兼容模型服务并关注用量成本。
核心亮点
- 内置成本感知路由,自动在多个 LLM 提供商间选择性价比最高的模型
- 自包含设计,无需复杂配置即可在终端内完成代码编辑和命令执行
- 支持 MCP,可扩展工具调用能力,提升自动化水平
不足之处
- 早期项目,文档和社区生态尚待完善
- 功能覆盖可能不如成熟 IDE 插件全面
适用场景
- 日常开发中快速修改代码片段,无需离开终端
- 自动化执行测试、构建等命令并智能分析输出
- 在多个 AI 模型间切换时,自动控制成本
替代项目
Aider、OpenCode、Cline
上一篇:harness-score
下一篇:it-tools
同类项目推荐
OpenSpec-Docs-zh
开源
看中文文档,快速上手 OpenSpec 规范驱动开发
OpenSpec 中文社区文档
builder
开源
说句话就生成网站和应用,开源自部署版 Lovable
✨ AI Builder For Creating Sites and Apps! An open-source alternative to Lovable, Re···
project-codeguard
开源
给 AI 写代码加一道默认安全护栏
Project CodeGuard is an open-source, model-agnostic security framework that embeds s···
alan-sdk-web
开源
给网页加上能听会说的AI助手,无需后端,快速上线
The Self-Coding System for Your App — Alan AI SDK for Web
skylos
开源
合并前自动扫PR,揪出死代码和AI错误
Open source local-first PR scanner that finds dead code, security bugs, secrets, qua···
nuppets
开源
Nuxt/Vue 开发者的快捷工具箱,片段和 AI 命令即取即用
A productivity hub for Nuxt and Vue.js development - Snippets, AI commands, and more···
demo2apk
开源
把聊天灵感一键打包成可安装的安卓App
Turn your Vibe Coding ideas into runnable Android Apps instantly
spark-stack
开源
用聊天对话直接生成 Web 应用,快速搭建 MVP。
Spark Stack is an tool for building web applications through an AI-powered chat inte···
amazon-q-developer-cli
开源
在终端里用大白话写代码,AI 帮你搞定。
✨ Agentic chat experience in your terminal. Build applications using natural langua···
