charmbracelet/crush
crush
Glamourous agentic coding for all 💘
使用指南
crush 是一个围绕 agentic-ai, llms, ravishing 的开源项目，当前在 GitHub 上有 25,826 stars。下面内容重点帮助你判断它适合什么场景、如何安装、如何完成第一次运行，以及采用前需要重点验证哪些风险。
核心功能亮点
- 主要使用 Go 实现，适合评估同技术栈下的集成成本。
- GitHub 未检测到仓库许可证，因此尚未确认商用授权。商用采用前需核对仓库条款，以及模型权重、数据集、依赖项或外部服务的许可要求。
- GitHub 仓库是主要评估入口，建议重点查看 README、issues 和最近提交。
适合场景
- 评估 crush 在 Go AI 工作流中的适用性。
- 对比一个拥有 25,826 stars 且仍有仓库活动的 GitHub 项目。
优点
- crush 已有 25,826 stars，可作为开发者关注度参考。 主题：agentic-ai, ai, llms。
- GitHub 仓库是当前主要评估入口。
限制
- 生产适配度仍取决于文档深度、issue 活跃度和发布节奏。
- 未检测到许可证，需要人工确认使用风险。
生产可用性
crush 在生产使用前，应结合 README、发布历史、开放 issue 和集成要求做验证。
许可证风险
GitHub 未报告许可证，生产使用前通常需要人工法务确认。
crush 架构预览
crush 的主路径是：入口进入 编程 Agent 运行时，再结合 Optional AI model、Runtime context、GitHub / Shell commands 完成处理，最后输出 面向用户的结果。
Entry
CLI / 终端入口
crush 主要通过开发者命令或终端工作流进入。
brew install charmbracelet/tap/crush
Runtime
编程 Agent 运行时
运行时读取开发者意图、检查仓库上下文、规划改动，并返回面向代码的动作。
coding workflow
Model
Optional AI model
当需要模型推理时，项目会把核心运行时连接到本地模型或托管 AI API。
model signal
Context
Runtime context
运行状态、用户输入、仓库文件或配置为每次任务提供上下文。
context signal
Tools
GitHub / Shell commands
工具适配器让运行时通过 GitHub / Shell commands 在模型之外执行动作。
GitHub, Shell commands
Output
面向用户的结果
最终输出会返回给用户、工作流、API 调用方或下游系统。
output
相关视频
Mariano Razo
Haz esto para que tu CRUSH te haga caso!😍🙈🤤
82,324,175 次观看 · 2023-09-21
安装教程
安装前准备
- Node.js and the package manager used by the project
- Local build tools for compiling the project
- A clean working directory for the first test run
确认运行环境
crush 可能需要本机构建工具链。先确认编译器、包管理器和系统依赖可用。
获取项目代码
从官方仓库或官方包开始，确保首次运行与文档描述一致。
$ git clone https://github.com/charmbracelet/crush.git安装或构建依赖
继续执行文档中检测到的下一步安装命令。
$ brew install charmbracelet/tap/crush采用建议与来源
适合场景
Glamourous agentic coding for all 💘
这是评估 crush 是否适合当前技术栈的一个文档化理由。
Focus area: agentic-ai
这是评估 crush 是否适合当前技术栈的一个文档化理由。
全部项目对比
在确定技术栈前，将 crush 与相似项目做对比。
采用前检查
- 先用 crush 的官方安装路径完成一次干净环境验证。
- 检查许可证、模型权重、外部服务和依赖包条款是否允许你的使用场景。
- 观察最近提交、发布节奏、issue 响应和文档完整度。
- 用小样本数据评估输出质量、延迟、资源占用和失败恢复方式。
配置注意事项
- Review README configuration notes before using production data.
常见问题与排错
- 安装失败时，先确认命令是在 README 指定目录执行，而不是仓库外层或错误子目录。
- 依赖冲突时，优先换成全新的虚拟环境、容器或工作目录重试。
- 运行结果不符合预期时，先退回 crush 文档里的最小示例，不要直接接入复杂数据。
- 涉及密钥、模型文件或外部服务时，逐项检查环境变量、文件路径和权限。
- 生产使用前检查最近更新、开放 issue、许可证和安全边界。
crush 是什么？
crush 是一个 全部 相关的开源项目。Glamourous agentic coding for all 💘
crush 怎么安装？
建议先按官方 README 执行安装命令。当前检测到的第一步是：git clone https://github.com/charmbracelet/crush.git。
crush 适合新手吗？
如果你熟悉 Go 生态，可以直接从最小示例开始；否则建议先在隔离环境中测试。
crush 可以商用吗？
GitHub 未检测到仓库许可证，因此尚未确认商用授权。商用采用前需核对仓库条款，以及模型权重、数据集、依赖项或外部服务的许可要求。
crush 需要 GPU 吗？
是否需要 GPU 取决于具体任务、模型和数据规模。首次测试建议先运行 README 中最小示例。
crush 如何判断是否值得采用？
建议同时观察安装成本、维护活跃度、issue 健康度、许可证和是否匹配你的实际工作流。