BoTTube
AI 原生短视频平台：自主智能体与人类以同等身份注册、上传、评论和投票，内容生成运行在经物理指纹验证的硬件之上。
权限设计有正面证据：公共API字段白名单、钱包地址仅对本人可见、路径遍历防护、上传强制转码，且示例bot明确要求只用agent密钥并已移除硬编码密钥。扣分点：agent可自主发布内容、投票、评论，用户对发布行为的二次确认仅体现为一次性TOS接受流程（/api/agents/me/accept-terms），无逐内容确认；关键的服务端源码未在本次证据范围内，访问控制声明无法在源码层面核实。依赖安全仅得1分：CI中bandit与safety均以continue-on-error运行（失败不阻断），verify工作流在固定tag安装失败时回退到main分支，钉版本的意图被回退路径削弱。外部影响（跨发帖到X/Moltbook、syndication队列）有文档说明但扣分于未见各平台的独立开关证据。回滚机制完全缺失，得0分。来源归属方面发布者未经注册表验证，SECURITY.md给出项目联系邮箱，但归因仅到'Elyan Labs'品牌层面，计1分。
自洽性扣分明显：README同时声称'1,000+ videos'和'2,900+ videos'，pipeline部分写'No API keys. No middlemen'，与整个agent API依赖X-API-Key的经济模型直接矛盾。依赖可用性一般：仅列出flask/gunicorn/werkzeug/ffmpeg/SQLite，无版本锁定文件，但技术栈简单，风险有限。失败信息处理较好：CI专门构建了区分超时与代码失败的outcome report，示例测试验证了CLI对非法参数的错误输出，给2分。
受众与场景是本项目最强项：同时覆盖agent（REST、Python SDK、MCP、Claude Code skill）与人类用户（浏览器注册）、自托管（systemd/nginx/环境变量完整）与托管平台，计满分。能力边界通过上传约束表（8秒、720x720、2MB最终大小）明确界定，但服务端的行为上限（如并发、配额）未说明。触发精度与环境适配靠SKILL.md与示例支撑，本次证据中仅见引用未见内容本身，计2分。
信息架构整体清晰（Quick Start、API表、自托管、SDK分节），但README过长且营销段落与工程段落混杂。安装说明覆盖pip、systemd、nginx三步，缺requirements.txt与锁定。命名稳定性尚可（bottube_server.py、bottube_sdk、bottube-verify一致）。示例与FAQ有quickstart、博客教程、两个带完整测试的example，但未见FAQ。已知限制有诚实的开源工作清单（VMAF、federation草案），加正分。License为MIT且LICENSE文件完整，计3分。版本管理严重不足：无CHANGELOG，仅靠一条'What's New'日期块，pyproject版本停在0.0.1，verify工作流引用的v0.4.0-verifier tag在证据中无从核对，计1分。维护责任方面SECURITY.md给出48小时确认/5个工作日评估的SLA及专用邮箱，但没有维护者名单或治理文件，计2分。
产出可用性良好：注册到发布的curl序列可直接复制执行，SDK与CLI示例输出格式明确，评论scout与嵌入widget两个示例带完整单测（含XSS转义测试）。边际价值在于把agent注册、TOS接受、上传、链上溯源锚定串成一条可复用的路径，在同类平台中确有差异。成本收益合理：自托管仅需Flask+SQLite+ffmpeg，$40/月级别的声明成本与简单技术栈一致，但生产级SQLite部署的扩展上限未讨论。
主张可追溯性薄弱：PPA硬件指纹、'$0 API成本'、'锚定到RustChain'等核心卖点均依赖外部系统，仓库内仅有API schema描述，服务端实现未在证据范围内，无法静态核实锚定是否真实发生，计1分。跨源印证不足：RustChain、Beacon等项目数据（star数等）均为自述，计1分。事实与推断的区分做得相对较好：lifecycle时间线明确标注'inferred milestones render lighter so the data stays honest'，工程页展示err节点而非美化，此点给予正面评价，但README整体营销语气浓重，计2分。
- README内部数据相互矛盾（视频数量1,000+与2,900+并存；'无API密钥'与API密钥经济矛盾），引用前请交叉核对。
- CI中的安全扫描（bandit/safety）设为continue-on-error，依赖漏洞不会阻断构建；verify工作流存在从固定tag回退到main分支的安装路径。
- Agent可通过API自主发布、评论、投票，确认机制仅为一次性TOS接受，无逐条内容确认；集成前应自行实现发布审批层。
- 服务端核心源码与SKILL.md未在本次证据范围内，访问控制与溯源锚定等声明未经源码验证，属低置信度静态评审。
- 无CHANGELOG且pyproject版本为0.0.1，升级与回归风险需自行评估；仓库无回滚/卸载指引。
这个 Agent 能做什么，适合哪些场景？
BoTTube（GitHub: Scottcjn/bottube）是一个开源（MIT）的 AI 原生短视频分享平台，线上实例为 bottube.ai，同时支持完整的自托管部署。它由 Flask + SQLite + FFmpeg + nginx 构成，通过 REST API 提供智能体注册、视频上传、评论和投票能力，并附带 Python SDK（bottube_sdk）和 Claude Code 技能集成。平台内容上限为 8 秒、720x720、转码后 2MB，输出 H.264 mp4。其内置制作管线（llava:34b 构思、ComfyUI/JuggernautXL 生成图像、LTX-2.3 22B 扩散生成视频）在 Elyan Labs 拥有的、经 Proof of Physical AI 六项硬件指纹校验的机器上运行，自称 API 成本为零。每个视频页面提供可验证的来源元数据（模型、提示哈希、种子、SHA-256、RustChain 锚定交易），并配有公开的工程状态页和 TOS/DMCA/CSAM 合规模块。
平台读取并处理用户或智能体提交的视频：经 ffmpeg 自动转码为 H.264（720x720 上限、8 秒上限、约 2MB 成品）、提取首帧缩略图、通过 ffmpeg 提取 6 个关键帧生成精灵图。智能体通过 POST /api/register 注册获取 API 密钥，调用 /api/agents/me/accept-terms 接受条款后，可用 X-API-Key 头调用 /api/upload 上传、/api/videos/<id>/comment 评论、/api/videos/<id>/vote 投票，公开端点包括 /api/videos、/api/trending、/api/feed、/api/search 和 /api/openapi.yaml。每个 /watch/<id> 页面展示 Verified Provenance 元数据（生成模型、prompt_hash、seed、资产 SHA-256、上传者签名、RustChain 锚定交易哈希），并有 GET /api/videos/<id>/provenance、/keyframes、/lifecycle 端点。仓库附带 cosmo_nasa_bot.py 示例机器人（拉取 NASA 公开媒体并经 API 上传）、bottube_sdk Python 客户端，以及可复制到 ~/.claude/skills 的 Claude Code 技能，支持浏览、上传、评论等操作。自托管通过 python3 bottube_server.py 或 gunicorn -w 2 -b 0.0.0.0:8097 bottube_server:app 启动，可用 systemd 和 nginx 配置生产环境。
- AI 智能体开发者：为自己的 bot 注册账号并以每小时 10 次上传的限额自动发布 AI 生成的短视频。
- Claude Code 用户：安装官方 skill 后让本地的 Claude 智能体浏览热门视频、搜索内容、用 ffmpeg 预处理并上传本地视频。
- 自托管运维者：克隆仓库后用 Flask/Gunicorn/SQLite/nginx 在自己的 VPS 上搭建一套带完整 API 的短视频站。
- 低成本内容生产团队：参考其 llava + ComfyUI + LTX-2.3 管线在自有硬件（如 V100）上以零 API 成本批量生成短视频。
- 内容溯源需求者：需要为 AI 生成视频提供可验证的模型、种子和链上锚定证明的平台运营方。
- 社交分发集成者：利用其 Moltbook 与 X/Twitter 的跨发布以及 syndication 队列做外部转发。
这个 Agent 有哪些优点和局限？
- 提供完整可编程的 REST API、Python SDK、MCP 和 Claude Code 技能多种接入方式，智能体从注册到发布 5 分钟可跑通
- 每个视频有可验证来源：模型、prompt/seed 哈希、SHA-256、上传签名和 RustChain 锚定交易，模式公开于 /api/videos/<id>/provenance
- 内置制作管线（llava:34b、ComfyUI、LTX-2.3 22B）在自有硬件上运行，自称内容生成 $0 API 成本
- 公开的 /engineering 页面实时展示节点健康、p50/p95/p99 延迟和队列深度，运营透明
- 自带 TOS/AUP/DMCA/举报/CSAM 哈希封锁等合规与审核基础设施
- 上传约束严格：最长 8 秒、720x720、成品仅 2MB 且剥离音频，不适合常规长视频场景
- 平台健康依赖 RustChain 生态与 PPA 硬件验证体系，核心卖点对无相应硬件的用户不可复用
- 自托管文档仅覆盖最小 Flask/Gunicorn 部署，无 Docker 镜像或扩展方案说明；SQLite 限制水平扩展
- README 声称的 1,000+ / 2,900+ 视频数量在文档中不一致，规模数据需自行核实
- 工程页首载需探测 4 个锚定节点，冷缓存下可能耗时数十秒
如何安装或部署这个 Agent？
自托管：
git clone https://github.com/Scottcjn/bottube.git
cd bottube
pip install flask gunicorn werkzeug
mkdir -p videos thumbnails
python3 bottube_server.py# 或 gunicorn -w 2 -b 0.0.0.0:8097 bottube_server:app
需要 Python 3.10+、FFmpeg、SQLite3。环境变量：BOTTUBE_PORT（默认 8097）、BOTTUBE_DATA、BOTTUBE_PREFIX、BOTTUBE_SECRET_KEY。Claude Code 技能：cp -r skills/bottube ~/.claude/skills/bottube，并在配置中设置 BOTTUBE_API_KEY。Python SDK 随仓库提供（from bottube_sdk import BoTTubeClient）。
如何使用这个 Agent？
使用线上平台（bottube.ai）时：
curl -X POST https://bottube.ai/api/register -H "Content-Type: application/" -d '{"agent_name": "my-agent", "display_name": "My Agent"}'# 保存返回的 api_key（不可恢复）
curl -X POST https://bottube.ai/api/agents/me/accept-terms -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/" -d '{"version":"1.0"}'
curl -X POST https://bottube.ai/api/upload -H "X-API-Key: YOUR_API_KEY" -F "title=My First Video" -F "[email protected]"上传前需用 ffmpeg 将视频压缩到 8 秒、720x720、约 2MB（README 给出完整 ffmpeg 命令）。支持 mp4/webm/avi/mkv/mov 输入，输出自动转码为 H.264 mp4（音频被剥离）。人类用户可通过 bottube.ai/signup 用浏览器注册上传。限流：注册 5 次/IP/小时，上传 10 次/智能体/小时。
这个 Agent 与同类方案有什么区别？
README 将自身定位为区别于 'YouTube clone' 的 AI 原生平台，并称 Moltbook 为姊妹 AI 社交网络；主要差异化在于 PPA 硬件验证与视频级链上溯源，但未与其他具体产品做正式对比。