
onefilellm
一键抓取代码、论文、视频字幕,生成干净文本喂给LLM
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2027
使用教程
环境要求
- Python 环境(可用 pip 安装依赖)
- git(用于克隆仓库,可选)
- 网络连接(抓取 GitHub、arXiv、网页等来源时需要)
- GitHub 个人访问令牌(推荐,用于提升 API 访问额度)
安装与启动步骤
-
1克隆项目仓库
把 onefilellm 源码下载到本地。如果直接使用 pip 安装包,可跳过此步。
git clone https://github.com/jimmc414/onefilellm.git -
2安装项目依赖
进入项目目录并安装 requirements.txt 中列出的依赖包,需联网。
cd onefilellm pip install -r requirements.txt -
3安装 CLI 命令
以可编辑模式安装,之后可直接使用 onefilellm 命令代替 python onefilellm.py。
pip install -e . -
4或直接 pip 安装
不想克隆仓库时,可直接从 PyPI 安装,CLI 和 Python API 均可使用。
pip install onefilellm -
5配置 GitHub Token
设置令牌后访问 GitHub 仓库、Issue、PR 更稳定,避免匿名调用受限。
export GITHUB_TOKEN="your_personal_access_token" -
6运行工具聚合内容
传入本地目录或 URL 等来源,工具会合并为单个 XML 文件并复制到剪贴板。
onefilellm ./docs/ https://github.com/user/project/issues/123
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
GITHUB_TOKEN | 否 | GitHub API 访问令牌,提升抓取额度与稳定性 | ghp_xxxxxxxxxxxxxxxx |
OFFLINE_MODE | 否 | 设为 1 时跳过所有网络操作,仅处理本地内容 | 1 |
.env | 否 | 放在项目根目录的环境变量文件,可写入上述配置 | GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxx |
~/.onefilellm_aliases/aliases.json | 否 | 别名存储文件,记录用户自定义的来源别名 | /home/user/.onefilellm_aliases/aliases.json |
如何确认成功
在终端运行 onefilellm 命令后,若生成结构化 XML 文本并自动复制到剪贴板,即表示部署成功。
常见问题
Q:不设置 GitHub Token 能用吗?
A:可以运行,但抓取 GitHub 内容时受匿名 API 速率限制,建议设置 GITHUB_TOKEN 以获得更稳定的访问。
Q:必须克隆仓库才能使用吗?
A:不是,可直接执行 pip install onefilellm 安装,CLI 与 Python API 均可正常使用,无需克隆源码。
Q:怎么在无网络环境下使用?
A:设置环境变量 OFFLINE_MODE=1,工具会跳过所有网络操作,只处理本地文件内容。
Q:安装后提示找不到 onefilellm 命令?
A:确认已执行 pip install -e . 或 pip install onefilellm,并检查该 pip 对应的 Scripts/bin 目录是否在 PATH 中。
注意事项
- GitHub Token 属于敏感信息,不要提交到代码仓库或公开分享。
- 环境变量和 .env 文件均可配置,.env 需放在项目根目录下。
- README 未列出具体命令行参数说明,使用时可通过 onefilellm --help 查看。
核心亮点
- 支持多源输入:GitHub仓库、PR、arXiv论文、YouTube字幕、网页文档,覆盖主流知识场景
- 自动清洗内容:过滤网页噪声、提取正文与代码,输出结构清晰的纯文本
- 一键复制到剪贴板:生成文件后自动复制,无缝粘贴到LLM对话或工具中
不足之处
- 依赖外部服务稳定性:Sci-Hub等非官方源可能因网络或法律问题失效
- 文档/社区待观察:项目文档和社区支持尚不完善,高级用法需自行摸索
适用场景
- 将GitHub开源项目代码库整理为单一文本,用于代码理解或生成文档
- 抓取arXiv论文并转为文本,辅助论文阅读或摘要生成
- 将YouTube视频字幕或网页教程转为文本,构建个人知识库
替代项目
gpt-repository-loader、llmware、txtai
同类项目推荐
lobster
开源
把多个工具串成一条流水线,Openclaw 一步调用
Lobster is a Openclaw-native workflow shell: a typed, local-first “macro engine” t···
flowgram.ai
开源
拖拽画布+内置物料,快速搭建 AI 工作流平台
FlowGram is an extensible workflow development framework with built-in canvas, form,···
open-dynamic-workflows
开源
一套工作流,跑遍所有主流AI编程助手
Open Dynamic Workflows: TypeScript CLI runtime for Claude Code-style dynamic workflo···
ralph
开源
循环跑AI编程CLI,每次全新会话,避免上下文污染
A configurable Bash/PowerShell loop that runs an AI coding CLI with a fresh session ···
ComfyUIMini
开源
手机上轻松跑 ComfyUI 工作流,随时随地出图
A mobile-friendly WebUI to run ComfyUI workflows.
WA-AKG
开源
自建 WhatsApp 网关,多账号定时群发与自动回复一站管
A self-hosted WhatsApp Gateway & Dashboard built with Next.js 16, Baileys, and Prism···
bytechef
开源
把 AI 智能体和自动化流程揉进一个平台,自己掌控
Open-source AI agents and workflow automation. Self-host or embed in your SaaS. Apac···
ars0n-framework-v2
开源
AI 帮你跑赏金流程,新手也能像老手一样挖洞
AI Native Bug Bounty Hunting Framework Designed to Help Beginners Compete w/ the Pro···
silentwolf
开源
无需官方API,轻松搭建WhatsApp自动化机器人
Silent Wolf WhatsApp automation bot.