yek

把整个代码库一键打包成 LLM 能懂的上下文

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 开源模型 🍴 复刻 65 🐛 待处理 12 👀 关注 4
GitHub ↗
GitHub 星标 ★ 2475
维护状态 低维护
是否开源 开源
定价模式 🏷️完全免费 开源工具,MIT 许可证,完全免费,可自行部署使用。

项目预览

yek 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类开源模型
开发团队mohsen1
定价模式🏷️完全免费
价格说明开源工具,MIT 许可证,完全免费,可自行部署使用。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言Rust
技术栈/模型ai,cli,large-language-models,llm,rust-lang,serialization
GitHub 星标★ 2475
上线时间2025-01-11 00:00:00
代码更新2026-06-29
仓库体积1.0 MB
本站数据更新2026-11-09
维护状态低维护
收录时间2026-08-09
浏览次数5

项目介绍

yek 是一个用 Rust 编写的高性能命令行工具,专门用于将仓库或目录中的文本文件序列化为适合大语言模型(LLM)消费的格式。它解决的核心问题是:在将代码库喂给 LLM 时,传统方法(如直接复制文件或使用 grep)效率低、上下文窗口浪费严重。yek 能够快速扫描整个仓库,自动过滤二进制文件、忽略无用文件(如 .git 目录),并将文本内容按结构化方式输出,方便 LLM 理解项目全貌。其核心能力包括极快的处理速度(得益于 Rust 的并发和内存安全)、智能的文件过滤与排序、以及可自定义的输出格式。它特别适合开发者在使用 AI 编程助手时快速提供项目上下文,或用于构建基于代码库的 RAG 系统。

Star 增长趋势

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

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2475

使用教程

难度:入门 约 5 分钟 部署方式:命令行工具 5 步

环境要求

  • Unix-like 系统(macOS 或 Linux);README 未提供完整的 Windows 安装命令
  • 能访问网络,安装脚本通过 curl 下载
  • 建议在 Git 仓库中运行,以便利用 .gitignore 和 Git 历史推断文件重要性
  • 安装命令依赖 curl(README 安装命令使用 curl -fsSL)

安装与启动步骤

  1. 1安装 yek

    在 macOS/Linux 终端执行官方安装脚本。注意:README 中 Windows 安装章节内容不完整,未给出命令。

    curl -fsSL https://azimi.me/yek.sh | bash
  2. 2进入目标目录

    切换到要序列化的仓库或目录,yek 会按当前目录内容处理并应用 .gitignore 规则。

    cd /your/project
  3. 3运行序列化

    默认直接运行即可序列化整个仓库,结果写入临时文件,控制台会打印该文件路径。

    yek
  4. 4管道输出内容

    yek 会自动检测输出是否被管道接管,若被管道接管则直接流式输出内容而不写文件。

    yek > context.txt
  5. 5使用自定义配置

    在项目根目录放置 yek.yaml,或用 --config-file 指定配置路径,自定义忽略规则、输出等。

    yek --config-file /your/path/yek.yaml

关键配置

配置项必填说明示例
max_size否输出大小上限,也支持用 tokens 单位128K
json否开启 JSON 格式输出false
debug否开启调试日志false
line_numbers否输出中包含行号false
tree_header否在开头包含目录树false

如何确认成功

运行 yek 后控制台打印出生成的临时文件路径,即表示序列化成功;用管道运行时则直接看到文件内容输出。

常见问题

Q:序列化结果保存在哪里?

A:默认写入临时目录中的一个文件,并把该文件路径打印到控制台。若输出被管道接管,则改为流式输出内容,不写文件。

Q:如何忽略不需要的文件?

A:默认使用 .gitignore 规则跳过文件,并自动推断额外的忽略模式(如二进制、大文件等),也可在 yek.yaml 中添加自定义忽略模式。

Q:为什么重要文件排在输出最后?

A:yek 会依据 Git 历史推断文件重要性,让更重要文件靠后出现,因为 LLM 通常更关注上下文末尾的内容。

Q:怎么修改输出大小或格式?

A:在项目根目录的 yek.yaml 中设置 max_size、json、line_numbers、tree_header 等,或用 --config-file 指定配置文件路径。

Q:Windows 怎么安装?

A:README 的 Windows 安装章节内容不完整、未给出具体命令,请以仓库最新 README 为准,本教程不虚构命令。

注意事项

  • 本教程命令全部来自 README,Windows 安装命令缺失故未提供。
  • 配置文件可放在项目根目录,也可通过 --config-file 指定自定义路径。
  • yek 支持一次处理多个目录、glob 模式与指定单个文件(README 提及但未给出具体命令示例)。
  • README 未说明具体端口、版本号或安装路径,教程中不做假设。

核心亮点

  • 基于 Rust 实现,处理大型仓库速度极快,节省等待时间
  • 自动过滤二进制和无关文件,有效节省 LLM 上下文窗口
  • 输出结构清晰,方便 LLM 理解项目文件层级和依赖关系

不足之处

  • 仅支持文本文件,对图片、PDF 等非文本内容无法处理
  • 文档/社区待观察

适用场景

  • 使用 AI 编程助手时快速提供整个项目的代码上下文
  • 构建基于代码库的 RAG 系统,作为数据预处理工具
  • 在 CI/CD 中自动生成项目摘要供 AI 分析

替代项目

RepoMix、gpt-repository-loader、code2prompt

上一篇:vllm-ascend

下一篇:mixtral-offloading

同类项目推荐

humming 开源

运行时生成量化矩阵乘内核,推理更快更灵活

Humming is a high-performance, lightweight, and highly flexible JIT (Just-In-Time) c···

★ 354 2026-10-28
hazmat 开源

给 AI 代理套上安全笼子,防破坏防泄露,还能一键回滚

Containment for AI agents - user isolation, sandboxed execution, network controls, b···

★ 179 2026-08-09
knowledgeops-agent 开源

快速搭建企业级安全可观测的 RAG 知识问答平台

Production-oriented Spring AI platform prototype for RAG, tool calling, async ingest···

★ 166 2026-08-09
openlit 开源

一键接入,全栈监控你的 LLM 应用,从开发到生产。

Same agent Smaller bill. The tools and infrastructure to get more work from your AI.···

★ 2970 2026-08-09
mxcp 开源

把企业数据安全接入大模型,让 AI 直接查数分析

Model eXecution + Context Protocol: Enterprise-Grade Data-to-AI Infrastructure

★ 68 2026-08-09
Wax 开源

在 Apple 设备上实现亚毫秒级本地 AI 记忆检索,无需服务器

Shared Single-file memory layer for all your agents, sub mili-second RAG over text, ···

★ 808 2026-08-09
Agent2API 开源

一个本地网关,把桌面 AI 客户端的额度变成标准 API

Local AI routing gateway with Agent client takeover — reuse existing client logins,···

★ 2036 2026-11-02
tunnel-client 开源

把本地 MCP 服务安全连到 ChatGPT 等 AI 工具,无需公网暴露

Customer-run client for Secure MCP Tunnel: connect private or localhost MCP servers ···

★ 624 2026-08-09
KVzip 开源

长文本推理显存直降4倍,延迟减半,即插即用

[NeurIPS'25 Oral] Query-agnostic KV cache eviction: 3–4× reduction in memory and 2···

★ 228 2026-08-09