如何用Python SDK调用Sirchmunk:几行代码实现智能搜索的实战教程
【免费下载链接】sirchmunk️ Sirchmunk: Raw data to self-evolving intelligence, real-time.项目地址https://gitcode.com/gh_mirrors/si/sirchmunk点击查看免费下载Sirchmunk是一个无需向量数据库和预索引的自进化搜索引擎支持从原始文件直接进行智能搜索与文档问答。本文将带你通过 Python SDK 快速上手只需几行代码就能让 LLM 在你的本地文档里做DEEP / FAST 双模式智能检索并自动沉淀可复用的知识。Sirchmunk 采用 LENS 框架预算约束下的证据探索无需向量索引即可在原始文档上检索️ Sirchmunk 智能搜索引擎是什么传统 RAG 方案要先做分块、嵌入、建向量库流程长且数据一变就过期。Sirchmunk 的思路完全不同无索引检索直接面向原始文件搜索即开即用零信息损失自进化知识搜索结果自动聚类为知识簇越用越懂你的文档预算感知LLM 调用只在高价值证据上投放成本可控整个搜索管线由核心类AgenticSearch编排入口定义在 src/sirchmunk/init.py搜索主逻辑位于 src/sirchmunk/search.py。1️⃣ 一键安装 SDK30秒搞定前置条件Python 3.10以及任意 OpenAI 兼容的 LLM API Key。# 创建虚拟环境推荐 conda create -n sirchmunk python3.13 -y conda activate sirchmunk # 安装 pip install sirchmunk⚠️ 首次初始化时SDK 会自动检测并尝试安装ripgrep-all和ripgrep高性能无索引文件检索的底层依赖。若自动安装失败请手动安装这两个工具。2️⃣ 配置 LLM一个类接入所有模型Sirchmunk 通过统一的OpenAIChat客户端接入任意 OpenAI 兼容端点OpenAI、DeepSeek、MiniMax、DashScope、Gemini 等实现见 src/sirchmunk/llm/openai_chat.py。from sirchmunk.llm import OpenAIChat llm OpenAIChat( api_keyyour-api-key, base_urlyour-base-url, # 例如 https://api.openai.com/v1 modelyour-model-name, # 例如 gpt-5.2、deepseek-chat )客户端内置自动重试、流式处理和用量统计不同提供商的能力如 thinking 模式会根据base_url自动协商无需额外配置。3️⃣ 几行代码实现智能搜索核心只需 3 步构建 LLM → 创建AgenticSearch→ 调用search()import asyncio from sirchmunk import AgenticSearch async def main(): agent_search AgenticSearch(llmllm) # DEEP 模式默认多路并行检索 证据探索返回 rich Markdown 报告 result await agent_search.search( query认证模块是如何工作的, paths[/path/to/documents], # 要搜索的目录或文件 modeDEEP, response_formatrich, ) print(result) asyncio.run(main())就这么简单——没有索引、没有分块、没有向量库直接把目录丢给它就能搜。DEEP / FAST / FILENAME_ONLY 三种模式怎么选模式速度 / LLM 调用适用场景FILENAME_ONLY极快 / 0 次只找文件名不用 LLMFAST1-5s / 0-2 次快速问答贪心早停优先复用知识簇DEEP默认5-30s / 4-6 次复杂分析多路并行检索 ReAct 精化search()还支持常用参数灵活控制max_loopsReAct 循环上限、max_token_budgettoken 预算默认 128K、include/excludeGlob 文件过滤、chat_history多轮对话上下文等完整签名见 src/sirchmunk/search.py。4️⃣ 按需求选择输出格式response_formatresponse_format参数决定search()的返回类型方便集成到不同下游取值返回内容典型用途rich默认富 Markdown 报告直接展示给用户minimal纯答案文本嵌入其他 Agent 流程json完整结构化字典程序化处理contextSearchContext对象获取答案 全部遥测数据其中SearchContextsrc/sirchmunk/schema/search_context.py不仅携带最终answer和知识簇cluster还记录了total_llm_tokenstoken 消耗、retrieval_logs每次检索操作明细等遥测信息非常适合做成本监控。5️⃣ 进阶让知识库越用越聪明知识图谱可视化知识簇的语义关联与生命周期状态Sirchmunk 的自进化体现在每次搜索的证据会被持久化为知识簇Knowledge Cluster基于 DuckDB 存储下次类似查询命中知识簇时可直接秒级复用跳过昂贵的检索过程。复用知识AgenticSearch默认开启reuse_knowledgeTrue自动从工作目录加载历史知识簇运行时进化构造时传入enable_knowledge_evolutionTrue搜索完成后后台异步执行四阶段演化连接合并、边刷新、元聚类发现、全局更新不阻塞搜索返回相关知识管理实现见 src/sirchmunk/learnings/knowledge_base.py 与 src/sirchmunk/scheduler/evolver.py。6️⃣ 常见坑与排查清单 ✅API 连不上确认api_key、base_url、model三个参数正确端点须为 OpenAI 兼容格式完整环境变量模板参考 config/env.example提示 ripgrep 缺失SDK 会自动尝试安装失败时需手动安装ripgrep与ripgrep-all搜索路径不对paths支持单个字符串或路径列表也可为单个文件初始化时也可通过AgenticSearch(paths[...])设置默认搜索范围想用 Web 界面安装pip install sirchmunk[web]然后运行sirchmunk web initsirchmunk web serve访问 http://localhost:8584 即可看到如下界面Sirchmunk Web UI流式日志聊天、基于文件的 RAG 与会话管理 总结步骤命令 / 代码安装pip install sirchmunk接入 LLMOpenAIChat(api_key..., base_url..., model...)创建搜索器AgenticSearch(llmllm)智能搜索await agent.search(query..., paths..., modeDEEP)从pip install到第一次智能搜索整个过程不到 5 分钟。Sirchmunk 让你跳过分块、嵌入、向量库这些繁琐基建直接把目录交给 LLM就能得到带证据溯源的智能答案。更多技术细节可参考仓库内的 benchmarks/README_ZH.md 与 AGENTS.md。赞分享【免费下载链接】sirchmunk️ Sirchmunk: Raw data to self-evolving intelligence, real-time.项目地址https://gitcode.com/gh_mirrors/si/sirchmunk点击查看免费下载相关推荐猫抓视频下载实操指南3 条安装路线4 个高频场景一次讲清猫抓视频下载实操指南3 条安装路线4 个高频场景一次讲清 想存一个网课视频页面上却没有下载按钮。猫抓cat catch正是为这类时刻准备的免费开源的音视频smolagents 实战指南用几行代码构建以代码思考的智能体smolagents 实战指南用几行代码构建以代码思考的智能体 本指南以仓库根目录 README.md https://link.gitcode.com/人工智能AI AgentAgent 框架工具调用代码智能体MCP ClientsAgent 沙箱7行代码实现智能网页搜索Browser-Use API实战指南7行代码实现智能网页搜索Browser Use API实战指南 你还在为手动提取网页数据浪费数小时还在处理JavaScript渲染内容时束手无策本文将展示人工智能AI Agent浏览器控制GUI 自动化MCP 服务创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

C++多线程弹窗恶搞程序:Windows API实战与安全边界

C++多线程弹窗恶搞程序:Windows API实战与安全边界

1. 项目缘起与整体设计思路1.1 这个弹窗程序到底是个什么东西先把这个项目的边界说清楚。所谓“弹窗恶搞”,本质上就是一个在目标机器上反复弹出窗口、让使用者无法正常操作的小程序。它不会加密文件、不会窃取数据、不会修改系统关键配置、不会自我复制传播&#x…

2026/10/12 18:05:34 阅读更多 →
MSBuild 常驻服务器工作节点所有权:进程外 Worker 的生命周期归属与复用机制解析

MSBuild 常驻服务器工作节点所有权:进程外 Worker 的生命周期归属与复用机制解析

构建工具开发工具CLI 【免费下载链接】msbuild The Microsoft Build Engine (MSBuild) is the build platform for .NET and Visual Studio. 项目地址: https://gitcode.com/gh_mirrors/ms/msbuild 点击查看 免费下载 导读 本文深入解析 MSBuild 仓库中一份处于 P…

2026/10/12 18:05:33 阅读更多 →
宽带瑞利信道下OFDM与OTFS误码率仿真对比:MATLAB实现与参数解析

宽带瑞利信道下OFDM与OTFS误码率仿真对比:MATLAB实现与参数解析

简介:面向本硕博无线通信教研的Matlab代码包,围绕宽带瑞丽衰减信道下的误码率对比展开,涵盖OFDM、OTFS、C-OFDM、C-OTFS四种方案,并统一采用16QAM调制。资源共10个文件,含9个Matlab脚本和1个AVI操作录像,压…

2026/10/12 18:04:32 阅读更多 →

最新新闻

CRF序列标注原理与实战:从全局最优解到工业级部署

CRF序列标注原理与实战:从全局最优解到工业级部署

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/13 1:01:48 阅读更多 →
Kibana汉化配置全解析:i18n.locale设置与版本兼容性指南

Kibana汉化配置全解析:i18n.locale设置与版本兼容性指南

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/13 1:01:48 阅读更多 →
FusionAccess虚拟桌面发放流程详解:从模板到用户登录的全链路拆解

FusionAccess虚拟桌面发放流程详解:从模板到用户登录的全链路拆解

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/13 1:01:48 阅读更多 →
Hibernate No identifier异常:实体缺少@Id的原因排查与修复全指南

Hibernate No identifier异常:实体缺少@Id的原因排查与修复全指南

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/13 1:01:48 阅读更多 →
进口变压器替换厂家怎么选?参数对照与CE认证全流程指南

进口变压器替换厂家怎么选?参数对照与CE认证全流程指南

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/13 1:01:48 阅读更多 →
claude-mem:为Claude Code打造自动跨会话记忆层

claude-mem:为Claude Code打造自动跨会话记忆层

最近一段时间一直在折腾一件事:让Claude Code在隔了一个晚上之后还能记得我昨天说过“这个模块用Python重写”以及“测试文件统一丢到tests目录”。中间试过各种“外置记忆”方案,最后真正解决问题的,是一个叫claude-mem的开源项目。claude-m…

2026/10/13 1:00:47 阅读更多 →

日新闻

物联网系统集成避坑指南:从选型到验收的关键要点

物联网系统集成避坑指南:从选型到验收的关键要点

做了这么多年物联网系统集成的项目,我最大的感受是,大部分坑不是出在技术前沿,而是出在一些看起来很平常的地方。设备选了便宜的、协议没问清楚、现场没摸透、验收标准写得含糊——这些细枝末节,最后都会变成延期、超支和扯皮的大…

2026/10/13 0:00:57 阅读更多 →
ESP32舵机控制全攻略:从PWM原理到高级玩法与常见故障排查

ESP32舵机控制全攻略:从PWM原理到高级玩法与常见故障排查

如果你玩ESP32有一阵子了,很难不碰到舵机控制这道坎。做智能小车要转方向,做机械臂要抬关节,做云台要偏航俯仰,背后都是同一个东西在干活:舵机。而我见过太多人卡在“代码能编译、舵机就是不听话”这个阶段&#xff0c…

2026/10/13 0:00:57 阅读更多 →
CAN总线原理与STM32实战:抗干扰、仲裁、错误处理全解析

CAN总线原理与STM32实战:抗干扰、仲裁、错误处理全解析

1. 为什么CAN总线至今仍是工业现场的“硬通货”?——从汽车底盘到智能温室的真实需求你有没有拆过一辆老款燃油车的中控台?或者调试过某高校实验室里那台跑着Modbus协议却频频丢帧的PLC控制柜?又或者,在某个农业物联网项目里&…

2026/10/13 0:00:57 阅读更多 →

周新闻

流感时间序列预测实战:ARIMA/LSTM全流程拆解与避坑指南

流感时间序列预测实战:ARIMA/LSTM全流程拆解与避坑指南

简介:基于 ARIMA、LSTM、Transformer 等模型的流感时间序列预测 Python 源码,面向计算机相关专业课程设计与期末大作业学生,以及项目实战学习者。内容覆盖预处理、平稳性检验、定阶、残差分析、多模型对比预测的完整时序建模流程,…

2026/10/12 0:16:30 阅读更多 →
影刀RPA新手教程:键盘模拟输入实战——输入文本与模拟按键的区别

影刀RPA新手教程:键盘模拟输入实战——输入文本与模拟按键的区别

影刀RPA新手教程:键盘模拟输入实战——输入文本与模拟按键的区别 做影刀RPA自动化,十个新手有八个栽在"往输入框里填东西"这件事上:要么填不进去,要么填了一半,要么直接把原来内容追加在后面。这背后的根因&…

2026/10/12 0:16:38 阅读更多 →
影刀RPA新手教程:阅文起点小说数据采集实战——书籍信息与章节内容

影刀RPA新手教程:阅文起点小说数据采集实战——书籍信息与章节内容

影刀RPA新手教程:阅文起点小说数据采集实战——书籍信息与章节内容 1. 认识影刀:什么场景该用RPA采小说数据 起点中文网的页面结构相对稳定——分类榜单、书籍详情、章节内容三块独立页面,跳转链路清晰。这种场景非常适合影刀自动化&#x…

2026/10/12 0:16:43 阅读更多 →

月新闻

我发现了一个新思路:用 Remotion + Claude Code 像写代码一样自动化生成短视频

我发现了一个新思路:用 Remotion + Claude Code 像写代码一样自动化生成短视频

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/12 21:05:09 阅读更多 →
Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式:TaoToken 统一 Key 配置与验证

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式:TaoToken 统一 Key 配置与验证

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/12 14:48:49 阅读更多 →
黑夜航拍船只数据集训练YOLOV5模型全流程解析

黑夜航拍船只数据集训练YOLOV5模型全流程解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/12 18:11:17 阅读更多 →