Lyapunov

用自然语言在 3D 场景里搭机器人、跑仿真

开源 🏷️定价信息待确认 ⏳ 访问状态待核验 行业应用 🍴 复刻 132 👀 关注 77
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 1267
维护状态 活跃
是否开源 开源
定价模式 🏷️定价信息待确认

项目预览

Lyapunov 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类行业应用
开发团队ManfredCh
定价模式🏷️定价信息待确认
价格说明定价信息待确认
访问状态⏳ 访问状态待核验
是否开源是
开源协议Apache-2.0
主要语言TypeScript
GitHub 星标★ 1267
上线时间2026-10-02 00:00:00
代码更新2026-11-20
仓库体积50.8 MB
本站数据更新2026-11-21
维护状态活跃
收录时间2026-11-21
浏览次数0

项目介绍

Lyapunov 是一个面向机器人研发与仿真的 3D 原生工作空间,以 LLM 作为交互与编排的第一入口。它把机器人模型、场景搭建、仿真运行和任务编排放在同一个三维界面里,用户可以用自然语言描述意图,由大模型理解并驱动场景操作与仿真流程,减少在建模工具、仿真器和脚本之间来回切换的成本。核心能力包括:3D 场景与机器人本体的可视化编辑、仿真运行与状态观察、基于 LLM 的任务与行为编排、面向机器人工作流的可扩展集成。项目用 TypeScript 实现,适合前端与全栈开发者快速上手和二次开发,当前处于成长期,社区规模不大但迭代活跃,适合做机器人仿真原型、教学演示和 LLM 驱动机器人工作流的探索性项目。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-11-21 · 当前星标 ★ 1267

使用教程

难度:入门 约 10 分钟 部署方式:本地安装 7 步

环境要求

  • 在图形桌面会话中的终端里执行安装,支持 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. 1执行安装脚本

    在图形桌面的终端运行官方安装脚本,它会读取当前发布清单,自动准备 MuJoCo 与 Python 运行时并创建启动器。

    curl -fsSL https://vorynel.com/lyapunov/install.sh | sh
  2. 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. 3启动应用

    安装成功并提示 ready 后单独启动;若 ~/.local/bin 已在 PATH 中,可直接输入 lyapunov 启动。

    "$HOME/.local/bin/lyapunov"
  4. 4首次运行设置

    欢迎页选择语言与主题;选择登录会在浏览器完成账号授权,选择访客则进入独立本地工作区。

  5. 5检查物理引擎

    默认安装只准备 MuJoCo,用 doctor 子命令检查其运行时与原生物理是否就绪。

    "$HOME/.local/bin/lyapunov" doctor mujoco
  6. 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
  7. 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 ···

★ 2087 2026-08-09
FinSight 开源

输入股票代码,一键生成专业级金融深度研究报告

[ACL 2026 Main, SAC Highlight] FinSight: Towards Real-World Financial Deep Research.···

★ 279 2026-08-09
BrLP 开源

用扩散模型预测脑病进展,一张扫描生成未来影像

[MICCAI, 2024] (Oral, RU @ MedIA Best Paper Award) Official implementation of the Br···

★ 140 2026-08-09
MITK-Diffusion 开源

扩散磁共振从数据到纤维束的一站式可视化处理

MITK Diffusion - Official part of the Medical Imaging Interaction Toolkit

★ 107 2026-11-12
FinLegal-Chat 开源

上传金融法律文档,直接对话问条款和风险

AI-Powered Chatbot for Financial Legal Document Analysis

★ 107 2026-09-14
moneyhelper 开源

一句话记账投研,本地算清每笔钱

Self-hosted finance that keeps the books for you: one sentence becomes journal entri···

★ 105 2026-11-11
recruitops-agent 开源

本地跑招聘智能体,自动筛简历、匹配岗位、跟投递

Local-first recruitment intelligence and application operations agent

★ 152 2026-09-30
Transtation-KMP 开源

用 KMP 打造多端 LLM 翻译应用,体验现代流畅交互

A translation app on Android/Desktop built by Kotlin Multiplatform + Compose Multipl···

★ 163 2026-08-09