项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-11-21 · 当前星标 ★ 1267
使用教程
环境要求
- 在图形桌面会话中的终端里执行安装,支持 Linux x64、macOS Apple Silicon
- Windows 用户需 Windows 10 build 19044+ 或 Windows 11,并启用 WSL2/WSLg(Ubuntu 24.04 及以上)
- 无需预先安装系统级 Node.js、Python、pip、Conda、Bun,也不需要模型密钥
- 磁盘上需有存放安装版本与用户数据的空间,默认位于 ~/.local/share/lyapunov/
安装与启动步骤
-
1执行安装脚本
在图形桌面的终端运行官方安装脚本,它会读取当前发布清单,自动准备 MuJoCo 与 Python 运行时并创建启动器。
curl -fsSL https://vorynel.com/lyapunov/install.sh | sh -
2先审阅脚本
想先确认脚本内容或选择已发布版本时,先把脚本下载到本地阅读,再用 --help 查看可用参数。
curl -fsSL https://vorynel.com/lyapunov/install.sh -o lyapunov-install.sh less lyapunov-install.sh sh lyapunov-install.sh --help sh lyapunov-install.sh -
3启动应用
安装成功并提示 ready 后单独启动;若 ~/.local/bin 已在 PATH 中,可直接输入 lyapunov 启动。
"$HOME/.local/bin/lyapunov" -
4首次运行设置
欢迎页选择语言与主题;选择登录会在浏览器完成账号授权,选择访客则进入独立本地工作区。
-
5检查物理引擎
默认安装只准备 MuJoCo,用 doctor 子命令检查其运行时与原生物理是否就绪。
"$HOME/.local/bin/lyapunov" doctor mujoco -
6按需装引擎
Newton、策略运行时和 Isaac Sim 属于可选下载;装 Isaac 前需先阅读并显式接受 Omniverse 许可。
"$HOME/.local/bin/lyapunov" install-provider newton "$HOME/.local/bin/lyapunov" install-provider policy-cpu "$HOME/.local/bin/lyapunov" install-provider isaac --accept-omniverse-eula -
7Windows 走 WSL2
Windows 用户在管理员 PowerShell 中安装并更新 WSL2,完成后在 WSL2 的 Ubuntu 终端执行前面的 Linux 安装步骤。
wsl --install wsl --update
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
--version | 否 | 指定安装某个已发布的版本号,不填则读取当前发布清单。 | 0.2.2-20261030 |
--prefix | 否 | 自定义安装目录,需绝对路径;支持含空格,但不接受含单引号的路径。 | /home/user/.local/share/lyapunov |
--bin-dir | 否 | 自定义启动器存放目录,需为绝对路径。 | /home/user/.local/bin |
PATH | 否 | 把启动器目录加入 PATH 后即可直接用 lyapunov 命令启动。 | $HOME/.local/bin |
如何确认成功
安装脚本执行完输出 ready,启动后出现欢迎页并能选择语言与主题;再运行 doctor mujoco 能正常返回引擎状态即视为成功。
常见问题
Q:需要先装 Node.js 或 Python 吗?
A:不需要。主归档已包含 Node.js、Electron 和固定版本运行时,默认安装会在版本目录内自建 MuJoCo 与 Python 环境,不依赖系统 PATH 里的 Node、Python、pip、Conda 或 Bun。
Q:Windows 可以直接安装吗?
A:Windows 用户需在 WSL2(Ubuntu 24.04 或更新)中安装 Linux 包,并依靠 WSLg 显示桌面窗口,系统要求 Windows 10 build 19044+ 或 Windows 11 以及合适的显卡驱动。
Q:访客模式和登录有什么区别?
A:访客使用独立的本地工作区,不连接产品账号与计费后端,也没有默认模型,需在模型设置中自行配置提供方;访客项目与登录后的项目互相隔离,可导出后再导入。
Q:Isaac Sim 必须安装吗?
A:不是必需。默认安装只准备 MuJoCo,Isaac Sim、Newton、策略运行时和官方基准套件都需要单独下载安装,用到时再装即可。
Q:怎么更新或回滚版本?
A:安装器把各版本放在 ~/.local/share/lyapunov/versions/ 下,校验通过后才切换 current 链接,旧版本与用户数据会保留;更新、回滚与卸载步骤见官方安装指南。
注意事项
- 安装目录与代码请放在 WSL 的 ext4 文件系统中(例如 ~ 下),不要放在 /mnt/c。
- 安装前缀若含单引号会被拒绝,因为默认 MuJoCo 运行时不支持该路径。
- WSL2 内的 GPU 访问由 Windows 端 NVIDIA 驱动提供,不要在 WSL 里再安装 Linux 显卡驱动。
- 物理引擎的选择变更会在下一次工作区启动时生效;可选模型与策略权重仅在被选中时才下载。
核心亮点
- 以 LLM 为第一交互入口,用自然语言驱动 3D 场景操作与仿真流程,降低机器人仿真的上手门槛
- 3D 原生设计,机器人模型、场景与仿真状态在同一工作空间内可视化,减少多工具切换
- TypeScript 技术栈,前端开发者易读易改,便于做定制化界面和集成
不足之处
- 项目处于成长期,生态与第三方集成相对有限
- LLM 驱动的编排依赖模型能力,复杂任务的稳定性与可复现性仍需验证
适用场景
- 机器人仿真原型快速搭建与演示
- LLM 驱动机器人任务编排的教学与研究实验
- 前端团队做 3D 机器人可视化工作台的二次开发
替代项目
Gazebo、Webots、MuJoCo
上一篇:Checkora
下一篇:open-net-worth
同类项目推荐
paca
开源
让 AI 代理和人类同看板协作,替代 Jira 的开源项目管理工具
Non-profit, community-owned and free forever: an AI-native, open-source alternative ···
FinSight
开源
输入股票代码,一键生成专业级金融深度研究报告
[ACL 2026 Main, SAC Highlight] FinSight: Towards Real-World Financial Deep Research.···
BrLP
开源
用扩散模型预测脑病进展,一张扫描生成未来影像
[MICCAI, 2024] (Oral, RU @ MedIA Best Paper Award) Official implementation of the Br···
MITK-Diffusion
开源
扩散磁共振从数据到纤维束的一站式可视化处理
MITK Diffusion - Official part of the Medical Imaging Interaction Toolkit
FinLegal-Chat
开源
上传金融法律文档,直接对话问条款和风险
AI-Powered Chatbot for Financial Legal Document Analysis
moneyhelper
开源
一句话记账投研,本地算清每笔钱
Self-hosted finance that keeps the books for you: one sentence becomes journal entri···
recruitops-agent
开源
本地跑招聘智能体,自动筛简历、匹配岗位、跟投递
Local-first recruitment intelligence and application operations agent
Transtation-KMP
开源
用 KMP 打造多端 LLM 翻译应用,体验现代流畅交互
A translation app on Android/Desktop built by Kotlin Multiplatform + Compose Multipl···
NBA-Machine-Learning-Sports-Bett···
开源
用机器学习预测NBA赛果,让博彩决策有数据支撑
NBA sports betting using machine learning
