Myriad-You/Myriad
Myriad-You/Myriad has 119 GitHub stars and 19 forks. GitHot measured +2 stars in 24 hours. Last checked 2026-11-16 19:27 UTC. Last push 2026-11-15.
实测星标增长
- 24小时
- +2
- 7天
- 正在收集历史
- 15天
- 正在收集历史
- 1个月
- 正在收集历史
各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。
关于
Myriad is a self-hosted homepage and creative studio: aggregate your platforms, show a library, and run a site-wide persona, 2.5D face, and Tapp apps you own.
开发工具README.zh-CN.md
原文
离屏渲染:仓库里的前端(生产构建)接一个本地实例逐帧画出来。站长、作品和数字都是合成的样例,形象是项目自带的角色。[怎么录的](docs/development/README_MEDIA.md)
它是什么
Myriad 是自托管的个人主页。 把你在各个平台留下的东西收进一个站点,再配一个全站一份的角色:她有自己的 2.5D 形象,陪来访的人聊天,也替你做事。站里还能装小应用、写博客。
单租户,可公开也可私有。PostgreSQL。界面:zh-CN · zh-TW · en-US · ja-JP · ko-KR · fr-FR · de-DE。
- 首页:标准 16×4 或自由 16×8 网格,小组件随你摆;自由布局还能贴贴纸。报告卡、音乐、天气、友链、最近活动、她的小组件都在这里,装好的 Tapp 也能放小组件。
- 平台:GitHub、Steam、Bilibili、网易云、Bangumi 等 11 个平台的数据写进同一个库,报告卡、资料库和平台报告读的是同一份(见 平台)。
和她说话
离屏渲染。她的回复是预先写好的替身,不是模型当场生成的。
- 全站一份人设:名字、性格、立绘由站长定,对谁说话都是同一个人;开着人设但没起名字时她叫 Arael。
- 聊天和做事:长按页面空白处叫出面板,Tab 在「聊天」「做事」之间切换。聊天时她用人设说话;做事时按授予的权限计划、确认、执行(见 Agent)。
- 口型:没开语音时,口型由回复的文字推出来,中文、日文、英文各按自己的发音。
2.5D 形象
离屏渲染。人物设定 › 动作调整。
在浏览器里动:上半身分层立绘由浏览器实时播放(Anime2.5DRig),服务器不做 GPU 推理。
从立绘到会动:主立绘可以生成也可以上传;分层来自 PSD,也可以交给拆层服务自动拆。眨眼、口型、头身摆动都在分层上做。
表情和动作:工作台里能直接试,聊天时她自己挑;有些表情会画上泪滴、音符、晕眩圈这样的符号。
转头是「画」出来的:导入时让图像编辑模型把同一张立绘重画成头向左右上下各转约 30° 的样子,拆层后逐个部件量出关键形;播放只是确定性的网格变形,不做推理。做法和测量见技术报告 Drawn, Not Computed。
引用
@misc{wang_2026_23598773,
author = {Wang, Mingen},
title = {Drawn, Not Computed: Measuring Live2D-Style Turn Keyforms from Generated Views of a Single Anime Illustration},
month = oct,
year = 2026,
publisher = {Zenodo},
doi = {10.5281/zenodo.23598773},
url = {https://doi.org/10.5281/zenodo.23598773},
}
平台报告
离屏渲染。报告文案是手写的样例;真实的报告由模型按平台数据写。
- 每个平台一份画像,分画像、口味、亮点三幕。没有单独的页面:点首页的报告卡,在弹窗里逐幕播放。
- 站长在同一处重新生成、设置有效期和报告风格。
资料库
离屏渲染。
- 游戏、番剧、影视、书籍、音乐,从连接的平台同步,按类型筛选,每类的来源可以设。
- 列表或无限画布:拖动、方向键平移、滚轮缩放;低端设备回退到列表。
Tapp
离屏渲染。生成过程是替身:步骤和代码是预先写好的,不是模型当场生成的。
- 站里的小应用:页面、首页小组件,或两者都有。跑在沙箱里,安装时批准权限;宿主密钥和应用凭据不进沙箱,报错里也不出现。
- 游乐场(桌面端,站长):说一句话生成项目,在生产沙箱里预览,满意了安装或导出
.tapp。 - 商店和 CLI:tapp-store,以及
tapp-cli(myriad-tapp init / check / pack)。开发见 Tapp 开发。
博客
离屏渲染。发布后由本地实例真的用 Hugo 重新生成了静态博客。
- 在创作台写笔记,发布后用 Hugo 主题生成静态博客,挂在
/blog。页面不跑脚本,评论和友链申请是同源的嵌入页。 - 订阅(RSS、Notion、RSSHub)在内置的「订阅」应用里读(见 Phantasi)。
还有
- 群聊和私聊:她也在 QQ、Telegram、Discord 的群里,被 @ 时回话,没人叫她时偶尔插一句;私聊 Bot 配对后走同一条做事的流水线。
- 联邦:ActivityPub 与 MFP,可以关注别的站点(见 联邦)。
- 换版与回滚:在
/config→ 关于 → 更新管理里一键完成(见 运维)。
目录
产品 — 和她说话 · 2.5D 形象 · 平台报告 · 资料库 · Tapp · 博客 · 平台 · Agent · Phantasi · 联邦 · 账号
参考 — 架构 · 仓库 · 技术构成 · 文档 · License
平台
GitHub — 仓库、Star、贡献 |
Bilibili — 收藏、追番、观看历史 |
写入 PostgreSQL。Report Card、资料库、平台报告读同一份数据。
Agent
Chat 人设开着时只用人设说话。无搜索、预订、生成、计划。允许换装,以及当前播放器的播 / 停 / 切歌。 |
Work 计划、确认、执行。记忆、技能、定时任务、MCP。范围由授予权限决定。 |
可对注意到的事项提出交给 Work 的提案;接受提案不是自治授权。可选 TTS、听写;配置语音 / 实时对话后可长按连续对话。
人设、Bot 配对、心跳在 /agent/settings,不在 /config。MCP 服务器列表仍在 /config → 高级配置;保存写 mcp_servers.json 并热重载子进程。私聊 Bot(QQ、Telegram、Discord、飞书)走进同一条办事流水线;配对不是新的登录方式。通道。
Phantasi
订阅、笔记与评论的后端。RSS、Notion、RSSHub,可选 AI 增强。已发布笔记用任意已安装的 Hugo 主题生成静态博客,挂在 /blog(文章 /blog/posts/{slug}/);页面不跑脚本,评论、友联申请和正文小组件是同源嵌入页。站长在 /studio 写作。订阅在内置的「订阅」阅读器应用里读。笔记 RSS(/api/phantasi/notes.xml)默认关闭,管理员开启后才公开。笔记支持 TeX 公式、联合作者、正文分栏与正文小组件。
联邦
ActivityPub + MFP。发现地址使用 BASE_URL。
关注:Actor URL(https://域名/users/<名>)或 @名@域名。支持频道与环网。WebFinger、NodeInfo、inbox、联邦媒体走 proxy → federation-worker,不进 SPA,也不进 web 进程。
出口地理位置落在受限地区时,联邦闸门会关掉联邦(探测失败则失败放行)。专用联邦进程随之退出;web 与 persona 继续跑。
说明:联邦。联邦域名迁移 ≠ 普通换域名。
账号与可见性
- 本地账号:所有者创建之后。注册可开可关。绑定 OAuth 后可关闭该用户的密码登录。
- OAuth: 内置 GitHub,以及任意 OIDC(Authentik、Keycloak、Google、Microsoft、GitLab、Discord……)。身份显式绑定;两个 issuer 上同一邮箱不合并。
- 页面可见性: 资料库、Phantasi、Tapp、Agent — 所有人 / 登录用户 / 管理员。
- 搜索与 AI: 私有(noindex、空 sitemap、无
/llms.txt)、仅搜索引擎、允许 AI 引用、完全开放。 - 站点身份: 名称、简介、图标、可选 PWA、壁纸与主题、第一方访客统计、可选 Google Analytics / Umami。
运维
生产:proxy + updater。仅 proxy 暴露宿主端口。web、federation-worker、persona-worker、frontend、Postgres、updater、updater-gateway、docker-guard 在内网。proxy 按路径把 persona / 联邦 / 其余 API 分开,见 PORTS.md。
换版与回滚:/config → 关于 → 更新管理。浏览器不获得 UPDATE_TOKEN。不要覆盖 :latest。
自带 Postgres:updater 快照 ./pgdata;回滚恢复数据目录与镜像 tag。外部 Postgres:MYRIAD_DB_MODE=external;回滚只恢复镜像 tag。外部 PostgreSQL。
约 1 GiB 主机可用内存节约档。/config 诊断执行实检查(数据库、存储、版本、出口、联邦闸门),报告不含凭据。
运行要求
生产(Docker)
- Docker + Compose
- 宿主端口(
HTTP_PORT,默认 80) - linux/amd64 或 linux/arm64
从源码
- Rust 1.99+
- Node.js 24 LTS
- PostgreSQL 18(Compose 默认;下限见 release
min_pg_version)
部署
Docker
git clone https://github.com/myriad-you/Myriad.git
cd Myriad
cp .env.production.example .env
# 必填:POSTGRES_PASSWORD / JWT_SECRET / CORS_ORIGINS
# BASE_URL / FRONTEND_URL = 公网源站(联邦发现使用 BASE_URL)
# UPDATE_TOKEN / UPDATER_GATEWAY_SECRET / PERSONA_DB_PASSWORD /
# FEDERATION_DB_PASSWORD 留空则由 deploy.sh 生成
bash scripts/extra/deploy.sh up
打开 http://localhost(或 HTTP_PORT),完成向导:数据库、所有者、站点名。
官方 Compose 已写入 DATABASE_URL,启动需要 MYRIAD_SETUP_SECRET(deploy.sh up 生成)。向导自行填写数据库时不使用该暗号。Setup 安装暗号。
host HTTP_PORT → proxy → frontend:1102
→ backend:1103 → postgres:5432
→ federation-worker:1103
→ persona-worker:1103
→ updater(内网;经 updater-gateway)
bash scripts/extra/deploy.sh status
bash scripts/extra/deploy.sh logs
bash scripts/extra/deploy.sh restart
bash scripts/extra/deploy.sh down
更新:/config → 关于 → 更新管理。手动改 tag:.env 中 MYRIAD_TAG / PROXY_TAG,然后 bash scripts/extra/deploy.sh upgrade。
自带 Postgres 备份:
mkdir -p backups
docker compose exec -T postgres pg_dump -U myriad -d myriad > "backups/backup_$(date +%Y%m%d_%H%M%S).sql"
在自己电脑上(Docker Desktop)
不需要域名和 TLS:步骤同上,.env 这样填。
BASE_URL/FRONTEND_URL:http://localhost或留空,不要留模板里的https://yourdomain.comCORS_ORIGINS:http://localhost;要在局域网其他设备上打开,再加上本机局域网地址(如http://192.168.1.20);HTTP_PORT不是 80 时带上端口- 局域网内用 http 打开也能登录。联邦和第三方登录需要公开的站点地址。
macOS 已演练过;Windows(WSL 2)未验证。本地部署
本地开发
共用核心是 git 子模块 core/(myriad-core),她的 2.5D 形象是 git 子模块 figure/(myriad-figure),Tapp 契约与运行时是 git 子模块 tapp/(myriad-tapp)。克隆之后、以及拉取后子模块指针变了时:
git submodule update --init
./scripts/dev.sh # TUI:菜单、进程、数据库、日志
./scripts/dev.sh start # 本机 PostgreSQL;日志在当前终端
./scripts/dev.sh start --docker # Docker postgres + 新终端
./scripts/dev.sh doctor # 工具链、端口、数据库
./scripts/dev.sh status # 快照
.\scripts\dev.ps1 start # Windows
后端 :1103,前端 :1102。无本机数据库时:./scripts/dev.sh db-setup。
前端 dev server 将 /api/*、/health、/ready 与联邦公开路径代理到后端。
开发 UI 中的更新管理:./scripts/dev.sh start all-updater。换镜像、维护模式、pgdata 快照走生产栈(scripts/extra/deploy.sh)。
架构
flowchart LR
Browser --> Proxy["proxy :HTTP_PORT"]
Proxy --> FE["frontend :1102"]
Proxy --> BE["web :1103"]
Proxy --> FW["federation-worker :1103"]
Proxy --> PW["persona-worker :1103"]
BE --> PG[("postgres :5432")]
FW --> PG
PW --> PG
BE --> GW[updater-gateway]
GW --> UP[updater]
UP --> Guard[docker-guard]
开发 / 生产拓扑
开发
browser → Vite dev (:1102)
└─ /api/*, /health, /ready, federation public paths → backend (:1103) → postgres
生产
host HTTP_PORT
→ proxy
├─► frontend (:1102) [myriad-net]
├─► backend (:1103) → postgres MYRIAD_PROCESS_ROLE=web
├─► federation-worker (:1103)
├─► persona-worker (:1103)
│
└─► backend ─► updater-gateway → updater [myriad-admin-net]
└─► docker-guard → Docker sock
(rescue) updater when PROXY_ALLOW_DIRECT_UPDATER=true
上图为内置 PostgreSQL,两个 worker 也直接连接同一数据库。使用独立外部 DB 容器时,backend 和两个 worker 都须与数据库接入 MYRIAD_BACKEND_EXTRA_NETWORK(默认 myriad-backend-ext)。更新器仅允许这三个服务接入该网络;旧版 updater/Guard 只认固定默认名,须先一起升级,再使用站内更新。见外部 PostgreSQL。
爬虫 / 应用内分享 UA 获得首页、资料库、Phantasi、Tapp 的 SEO HTML 壳;浏览器获得 SPA。架构。
仓库
Myriad/
├── backend/ Rust API、SeaORM、migrations
├── frontend/ Vite + React UI、Tapp 运行时、i18n(7 种宿主 locale)
├── proxy/ 生产反向代理(独立 Cargo 树)
├── updater/ 自更新守护进程(独立 Cargo 树)
├── core/ 共用核心(git 子模块:myriad-core)
├── tapp/ Tapp 契约、规则、共用运行时、CLI、作者文档(git 子模块:myriad-tapp;独立 Cargo 树)
├── crates/ 工作区库
├── shared/ 跨组件静态配置
├── docker/ backend / frontend Dockerfile
├── docs/ 开发、部署、功能(中文)
├── scripts/ dev.sh / dev.ps1;extra/ 部署
├── release/ release.json 契约
└── docker-compose*.yml
proxy、updater 与 tapp 为独立 Cargo 树。
技术构成
前端 现场形象 语音 |
后端 数据 边缘 扩展 部署 |
文档
目前为中文。门户。
赞助
Myriad 公开开发,靠使用它的人一起支撑。如果它对你有用,欢迎支持我们继续走下去:
感谢每一位支持我们的你。
贡献
欢迎 Issue 与 PR。UI 文案:zh-CN / zh-TW / en-US / ja-JP / ko-KR / fr-FR / de-DE。
贡献者
AI 协作者
Myriad 有大量代码是和编程 agent 一起写的。它们的提交带有 Co-Authored-By 署名,所以也会出现在 GitHub 的贡献者列表里。
License
主应用(backend / frontend 及工作区 crate)与 proxy / updater 均为 AGPL-3.0。只通过文档化 Bridge 通信的 Tapp 是独立作品,许可由作者自选(见 LICENSE 中 AGPL 第 7 条附加许可)。
Tapp 契约与工具(tapp/crates/tapp-contract、tapp/shared/tapp_sandbox_contract.json、tapp/tools/tapp-cli、tapp/tools/tapp-contract-export)为 Apache-2.0。
2.5D 播放:Anime2.5DRig(MIT)。
