xerj-org/xerj

项目概览

该项目以单个静态二进制文件分发且无 JVM 与外部依赖，通过自动推断数据集并创建索引免除了模式配置或流水线构建。它兼容 Kibana 且实现了包含索引、文档、搜索、聚合等在内的 Elasticsearch REST API 端点，使现有依赖 Elasticsearch 技术栈的 Agent 检索系统具备低门槛替换与验证的可能性。

项目类型

AI Agent · RAG 与知识库 · AI 搜索

应用场景

知识问答 · 搜索调研 · 编程开发

部署方式

查看项目说明

License

Apache-2.0

适合谁

• 希望降低智能体读取文件时 Token 消耗的开发者。
• 需要处理多格式数据并自动推断数据集建立索引的场景。

核心能力

• 自动探查文件，推断数据集，并在无需模式配置或流水线的情况下为每个数据集创建索引。
• 实现了 Elasticsearch REST API，包含索引、文档、批量操作、搜索、聚合、映射、kNN、滚动、重建索引以及 _cat 端点。
• 通过 tree-sitter 解析源文件，使代码连同其符号和行号一起被索引，而不是作为纯文本进行索引。
• 在单个查询中提供全文、向量和混合检索，无需单独的向量数据库。
• 处理多种文件格式，包括 CSV、JSON、JSONL、XML、YAML、SQLite、PDF、DOCX、HTML 以及常见的日志格式。

限制与风险

• 与 Elasticsearch 相比，在高频率并发写入冲击下，读取操作的 p99 延迟会受到影响。

如何开始

• 由于提供无依赖的单二进制文件且无需模式配置即可自动创建索引，上手难度为容易。首次成功路径仅需安装二进制文件、启动服务器并运行 autoindex 命令，交互方式为命令行，不要求进行编码。

替代方案与同类比较

• 同为面向 Agent 的检索引擎，但侧重于提供连续记忆写入、探索分支和回滚能力的状态存储，支持托管服务。

同类比较

• xerj-org/xerj vs Agent 检索与状态数据库

核验依据

• README: XERJ is a search engine for AI agents.
• README: One static binary, no JVM, no dependencies. Prebuilt for Linux, macOS and Windows on x86-64 and arm64.
• README: Agents burn their context window reading files. The PHP in WordPress core is about 5.2 million tokens, or 26 full context windows, so an agent cannot simply read it.
• README: ES conformance
• README: All four losses are the same gap: read p99 while a high-rate writer runs.

来源更新时间：2026-08-03T18:05:18Z

打开原始 GitHub 项目