nickvasilescu/parallax

项目介绍

Parallax 是一个 Web 应用，把图片、视频、声音和音乐四个工作室，以及基于它们衍生的重绘、分镜电影、竖版短片、广告投放、单一用途小工具整合在一起，另外还有社区信息流、个人素材库、积分、开发者 API 和 MCP 服务器。它面向想自己部署 AI 媒体工作室而非使用托管产品的用户，也适合想参考「多个模型统一接入」实现方式的开发者。

模型调用统一经过 treg.to 网关，每个模型的可调参数、输入和精确价格集中在 registry 里定义，并可用预算变量限制 24 小时内的付费请求总额。/supercomputer 的智能体聊天支持三种引擎：脚本模拟、Parallax 自己的循环，以及跑在云电脑（例如 Orgo）上的外部 Hermes 智能体。用 Hermes 时，智能体通过 MCP 调用工作室工具，真正生成前会弹出带价格的审批卡，由用户用积分支付；生成密钥始终留在 Parallax 内部。

快速使用

需要 Node.js 22.13 或更新版本，应用使用 Node 内置的 SQLite，不需要单独安装数据库。然后执行：

git clone https://github.com/nickvasilescu/parallax.git
cd parallax
npm ci
PARALLAX_DEMO_SEED=1 npm run dev

打开 http://localhost:3000，以访客身份用少量初始积分体验。种子变量会写入四个演示账号和约六十条已发布内容，每条都附带生成时的提示词，Recreate 可以直接复用；不需要时去掉该变量即可得到空信息流。此模式下不需要任何模型密钥，所有模型都返回内置示例文件。

要做真实生成，把 .env.example 复制为 .env.local 并设置 TREG_TOKEN；试用期间把 TREG_DAILY_BUDGET_USD 设低。后台运行则先 npm ci && npm run build，再执行 deploy/start.sh mock（去掉 mock 即为真实生成），数据和日志放在 deploy/run/。

使用约束

• 没有支付处理：充值按钮直接送积分并在界面上注明这一点，可用 PARALLAX_DEMO_BILLING=off 关闭。首页的 LAUNCH-WEEK 优惠码和折扣标签是示例营销文案，对外运行前应替换。
• Hermes 引擎只与模拟智能体做过端到端测试，尚未对接真实 Hermes 智能体。外部智能体自带的 shell、文件和记忆工具不受 Parallax 审批卡约束，因此不要把人个人智能体暴露给公网 Parallax，安全拓扑见 Hermes-on-Orgo 指南。
• SUPER_MODE=live 能启动云电脑并连接外部应用，两者都可能产生费用，且测试程度远低于工作室功能。Canvas 画板只存在浏览器本地，Horizon 是预览页。
• 部署到公网前先读 SECURITY.md。项目以 MIT 协议开源，是独立项目，与所接入的模型和服务厂商没有隶属关系。

HotRepo 点评

在 2026-11-15 的 TypeScript 新项目榜上，该仓库记录到 109 star、80 fork，约 1.5 小时的统计窗口内新增 8 star 和 6 fork；Star 采样显示 07:46 至 08:46 UTC 从 104 涨到 109。对一个年轻项目来说，fork 与 star 的比例相当高，说明有人是在克隆来运行而不是只浏览，但这只是单次快照，不足以说明采用情况。更值得关注的是技术范围：MIT 协议、带模拟模式、带价格校验的模型 registry，以及把智能体接到外部 Hermes 的文档路径。README 也坦承 Hermes 路径和 live 智能体模式是测试最少的部分，决定是否部署时这一点比 star 数更重要。