[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-2174":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":23,"hasPages":23,"topics":25,"createdAt":10,"pushedAt":10,"updatedAt":26,"readmeContent":27,"aiSummary":28,"trendingCount":16,"starSnapshotCount":16,"syncStatus":29,"lastSyncTime":30,"discoverSource":31},2174,"genesis-world","Genesis-Embodied-AI\u002Fgenesis-world","Genesis-Embodied-AI","Simulation platform for general-purpose robotics & embodied AI learning.","https:\u002F\u002Fgenesis-world.readthedocs.io",null,"Python",29313,2777,224,104,0,13,77,562,64,45,"Apache License 2.0",false,"main",[],"2026-06-12 02:00:38","![Genesis](imgs\u002Fbig_text.png)\r\n\r\n![Teaser](imgs\u002Fteaser.png)\r\n\r\n[![PyPI - Version](https:\u002F\u002Fimg.shields.io\u002Fpypi\u002Fv\u002Fgenesis-world)](https:\u002F\u002Fpypi.org\u002Fproject\u002Fgenesis-world\u002F)\r\n[![PyPI Downloads](https:\u002F\u002Fstatic.pepy.tech\u002Fbadge\u002Fgenesis-world)](https:\u002F\u002Fpepy.tech\u002Fprojects\u002Fgenesis-world)\r\n[![GitHub Issues](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues\u002FGenesis-Embodied-AI\u002FGenesis)](https:\u002F\u002Fgithub.com\u002FGenesis-Embodied-AI\u002FGenesis\u002Fissues)\r\n[![GitHub Discussions](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fdiscussions\u002FGenesis-Embodied-AI\u002FGenesis)](https:\u002F\u002Fgithub.com\u002FGenesis-Embodied-AI\u002FGenesis\u002Fdiscussions)\r\n[![Discord](https:\u002F\u002Fimg.shields.io\u002Fdiscord\u002F1322086972302430269?logo=discord)](https:\u002F\u002Fdiscord.gg\u002FnukCuhB47p)\r\n\u003Ca href=\"https:\u002F\u002Fdrive.google.com\u002Fuc?export=view&id=1ZS9nnbQ-t1IwkzJlENBYqYIIOOZhXuBZ\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FWeChat-07C160?style=for-the-badge&logo=wechat&logoColor=white\" height=\"20\" style=\"display:inline\">\u003C\u002Fa>\r\n\r\n\r\n# Genesis\r\n\r\n## 🔥 News\r\n- [2025-08-05] Released v0.3.0 🎊 🎉\r\n- [2025-07-02] The development of Genesis is now officially supported by [Genesis AI](https:\u002F\u002Fgenesis-ai.company\u002F).\r\n- [2025-01-09] We released a [detailed performance benchmarking and comparison report](https:\u002F\u002Fgithub.com\u002Fzhouxian\u002Fgenesis-speed-benchmark) on Genesis, together with all the test scripts.\r\n- [2025-01-08] Released v0.2.1 🎊 🎉\r\n- [2025-01-08] Created [Discord](https:\u002F\u002Fdiscord.gg\u002FnukCuhB47p) and [Wechat](https:\u002F\u002Fdrive.google.com\u002Fuc?export=view&id=1ZS9nnbQ-t1IwkzJlENBYqYIIOOZhXuBZ) group.\r\n- [2024-12-25] Added a [docker](#docker) including support for the ray-tracing renderer\r\n- [2024-12-24] Added guidelines for [contributing to Genesis](https:\u002F\u002Fgithub.com\u002FGenesis-Embodied-AI\u002FGenesis\u002Fblob\u002Fmain\u002F.github\u002Fcontributing\u002FPULL_REQUESTS.md)\r\n\r\n## Table of Contents\r\n\r\n1. [What is Genesis?](#what-is-genesis)\r\n2. [Key Features](#key-features)\r\n3. [Quick Installation](#quick-installation)\r\n4. [Docker](#docker)\r\n5. [Documentation](#documentation)\r\n6. [Contributing to Genesis](#contributing-to-genesis)\r\n7. [Support](#support)\r\n8. [License and Acknowledgments](#license-and-acknowledgments)\r\n9. [Associated Papers](#associated-papers)\r\n10. [Citation](#citation)\r\n\r\n## What is Genesis?\r\n\r\nGenesis is a physics platform designed for general-purpose *Robotics\u002FEmbodied AI\u002FPhysical AI* applications. It is simultaneously multiple things:\r\n\r\n1. A **universal physics engine** re-built from the ground up, capable of simulating a wide range of materials and physical phenomena.\r\n2. A **lightweight**, **ultra-fast**, **pythonic**, and **user-friendly** robotics simulation platform.\r\n3. A powerful and fast **photo-realistic rendering system**.\r\n4. A **generative data engine** that transforms user-prompted natural language description into various modalities of data.\r\n\r\nPowered by a universal physics engine re-designed and re-built from the ground up, Genesis integrates various physics solvers and their coupling into a unified framework. This core physics engine is further enhanced by a generative agent framework that operates at an upper level, aiming towards fully automated data generation for robotics and beyond.\r\n\r\n**Note**: Currently, we are open-sourcing the _underlying physics engine_ and the _simulation platform_. Our _generative framework_ is a modular system that incorporates many different generative modules, each handling a certain range of data modalities, routed by a high level agent. Some of the modules integrated existing papers and some are still under submission. Access to our generative feature will be gradually rolled out in the near future. If you are interested, feel free to explore more in the [paper list](#associated-papers) below.\r\n\r\nGenesis aims to:\r\n\r\n- **Lower the barrier** to using physics simulations, making robotics research accessible to everyone. See our [mission statement](https:\u002F\u002Fgenesis-world.readthedocs.io\u002Fen\u002Flatest\u002Fuser_guide\u002Foverview\u002Fmission.html).\r\n- **Unify diverse physics solvers** into a single framework to recreate the physical world with the highest fidelity.\r\n- **Automate data generation**, reducing human effort and letting the data flywheel spin on its own.\r\n\r\nProject Page: \u003Chttps:\u002F\u002Fgenesis-embodied-ai.github.io\u002F>\r\n\r\n## Key Features\r\n\r\n- **Speed**: Over 43 million FPS when simulating a Franka robotic arm with a single RTX 4090 (430,000 times faster than real-time).\r\n- **Cross-platform**: Runs on Linux, macOS, Windows, and supports multiple compute backends (CPU, Nvidia\u002FAMD GPUs, Apple Metal).\r\n- **Integration of diverse physics solvers**: Rigid body, MPM, SPH, FEM, PBD, Stable Fluid.\r\n- **Wide range of material models**: Simulation and coupling of rigid bodies, liquids, gases, deformable objects, thin-shell objects, and granular materials.\r\n- **Compatibility with various robots**: Robotic arms, legged robots, drones, *soft robots*, and support for loading `MJCF (.xml)`, `URDF`, `.obj`, `.glb`, `.ply`, `.stl`, and more.\r\n- **Photo-realistic rendering**: Native ray-tracing-based rendering.\r\n- **Differentiability**: Genesis is designed to be fully differentiable. Currently, our MPM solver and Tool Solver support differentiability, with other solvers planned for future versions (starting with rigid & articulated body solver).\r\n- **User-friendliness**: Designed for simplicity, with intuitive installation and APIs.\r\n\r\n## Quick Installation\r\n\r\n### Using pip\r\n\r\nInstall **PyTorch** first following the [official instructions](https:\u002F\u002Fpytorch.org\u002Fget-started\u002Flocally\u002F).\r\n\r\nThen, install Genesis via PyPI:\r\n```bash\r\npip install genesis-world  # Requires Python>=3.10,\u003C3.14;\r\n```\r\n\r\nFor the latest version to date, make sure that `pip` is up-to-date via `pip install --upgrade pip`, then run command:\r\n```bash\r\npip install git+https:\u002F\u002Fgithub.com\u002FGenesis-Embodied-AI\u002FGenesis.git\r\n```\r\nNote that the package must still be updated manually to sync with main branch.\r\n\r\nUsers seeking to contribute are encouraged to install Genesis in editable mode. First, make sure that `genesis-world` has been uninstalled, then clone the repository and install locally:\r\n```bash\r\ngit clone https:\u002F\u002Fgithub.com\u002FGenesis-Embodied-AI\u002FGenesis.git\r\ncd Genesis\r\npip install -e \".[dev]\"\r\n```\r\nIt is recommended to systematically execute `pip install -e \".[dev]\"` after moving HEAD to make sure that all dependencies and entrypoints are up-to-date.\r\n\r\n### Using uv\r\n\r\n[uv](https:\u002F\u002Fdocs.astral.sh\u002Fuv\u002F) is a fast Python package and project manager.\r\n\r\n**Install uv:**\r\n```bash\r\n# On macOS and Linux\r\ncurl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\r\n\r\n# On Windows\r\npowershell -ExecutionPolicy ByPass -c \"irm https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.ps1 | iex\"\r\n```\r\n\r\n**Quick start with uv:**\r\n```bash\r\ngit clone https:\u002F\u002Fgithub.com\u002FGenesis-Embodied-AI\u002FGenesis.git\r\ncd Genesis\r\nuv sync\r\n```\r\n\r\nThen install PyTorch for your platform:\r\n\r\n```bash\r\n# NVIDIA GPU (CUDA 12.6 as an example)\r\nuv pip install torch --index-url https:\u002F\u002Fdownload.pytorch.org\u002Fwhl\u002Fcu126\r\n\r\n# CPU only (Linux\u002FWindows)\r\nuv pip install torch --index-url https:\u002F\u002Fdownload.pytorch.org\u002Fwhl\u002Fcpu\r\n\r\n# Apple Silicon (Metal\u002FMPS)\r\nuv pip install torch\r\n```\r\n\r\nRun an example:\r\n```bash\r\nuv run examples\u002Frigid\u002Fsingle_franka.py\r\n```\r\n\r\n## Docker\r\n\r\nIf you want to use Genesis from Docker, you can first build the Docker image as:\r\n\r\n```bash\r\ndocker build -t genesis -f docker\u002FDockerfile docker\r\n```\r\n\r\nThen you can run the examples inside the docker image (mounted to `\u002Fworkspace\u002Fexamples`):\r\n\r\n```bash\r\nxhost +local:root # Allow the container to access the display\r\n\r\ndocker run --gpus all --rm -it \\\r\n-e DISPLAY=$DISPLAY \\\r\n-e LOCAL_USER_ID=\"$(id -u)\" \\\r\n-v \u002Fdev\u002Fdri:\u002Fdev\u002Fdri \\\r\n-v \u002Ftmp\u002F.X11-unix\u002F:\u002Ftmp\u002F.X11-unix \\\r\n-v $(pwd):\u002Fworkspace \\\r\n--name genesis genesis:latest\r\n```\r\n\r\n### AMD users\r\nAMD users can use Genesis using the `docker\u002FDockerfile.amdgpu` file, which is built by running:\r\n```\r\ndocker build -t genesis-amd -f docker\u002FDockerfile.amdgpu docker\r\n```\r\n\r\nand can then be used by running:\r\n\r\n```xhost +local:docker \\\r\ndocker run -it --network=host \\\r\n --device=\u002Fdev\u002Fkfd \\\r\n --device=\u002Fdev\u002Fdri \\\r\n --group-add=video \\\r\n --ipc=host \\\r\n --cap-add=SYS_PTRACE \\\r\n --security-opt seccomp=unconfined \\\r\n --shm-size 8G \\\r\n -v $PWD:\u002Fworkspace \\\r\n -e DISPLAY=$DISPLAY \\\r\n genesis-amd\r\n ```\r\n\r\nThe examples will be accessible from `\u002Fworkspace\u002Fexamples`. Note: AMD users should use the ROCm (HIP) backend. This means you will need to call `gs.init(backend=gs.amdgpu)` to initialise Genesis.\r\n\r\n## Documentation\r\n\r\nComprehensive documentation is available in [English](https:\u002F\u002Fgenesis-world.readthedocs.io\u002Fen\u002Flatest\u002Fuser_guide\u002Findex.html), [Chinese](https:\u002F\u002Fgenesis-world.readthedocs.io\u002Fzh-cn\u002Flatest\u002Fuser_guide\u002Findex.html), and [Japanese](https:\u002F\u002Fgenesis-world.readthedocs.io\u002Fja\u002Flatest\u002Fuser_guide\u002Findex.html). This includes detailed installation steps, tutorials, and API references.\r\n\r\n## Contributing to Genesis\r\n\r\nThe Genesis project is an open and collaborative effort. We welcome all forms of contributions from the community, including:\r\n\r\n- **Pull requests** for new features or bug fixes.\r\n- **Bug reports** through GitHub Issues.\r\n- **Suggestions** to improve Genesis's usability.\r\n\r\nRefer to our [contribution guide](https:\u002F\u002Fgithub.com\u002FGenesis-Embodied-AI\u002FGenesis\u002Fblob\u002Fmain\u002F.github\u002Fcontributing\u002FPULL_REQUESTS.md) for more details.\r\n\r\n## Support\r\n\r\n- Report bugs or request features via GitHub [Issues](https:\u002F\u002Fgithub.com\u002FGenesis-Embodied-AI\u002FGenesis\u002Fissues).\r\n- Join discussions or ask questions on GitHub [Discussions](https:\u002F\u002Fgithub.com\u002FGenesis-Embodied-AI\u002FGenesis\u002Fdiscussions).\r\n\r\n## License and Acknowledgments\r\n\r\nThe Genesis source code is licensed under Apache 2.0.\r\n\r\nGenesis's development has been made possible thanks to these open-source projects:\r\n\r\n- [Taichi](https:\u002F\u002Fgithub.com\u002Ftaichi-dev\u002Ftaichi): High-performance cross-platform compute backend. Kudos to the Taichi team for their technical support!\r\n- [FluidLab](https:\u002F\u002Fgithub.com\u002Fzhouxian\u002FFluidLab): Reference MPM solver implementation.\r\n- [SPH_Taichi](https:\u002F\u002Fgithub.com\u002Ferizmr\u002FSPH_Taichi): Reference SPH solver implementation.\r\n- [Ten Minute Physics](https:\u002F\u002Fmatthias-research.github.io\u002Fpages\u002FtenMinutePhysics\u002Findex.html) and [PBF3D](https:\u002F\u002Fgithub.com\u002FWASD4959\u002FPBF3D): Reference PBD solver implementations.\r\n- [MuJoCo](https:\u002F\u002Fgithub.com\u002Fgoogle-deepmind\u002Fmujoco): Reference for rigid body dynamics.\r\n- [libccd](https:\u002F\u002Fgithub.com\u002Fdanfis\u002Flibccd): Reference for collision detection.\r\n- [PyRender](https:\u002F\u002Fgithub.com\u002Fmmatl\u002Fpyrender): Rasterization-based renderer.\r\n- [LuisaCompute](https:\u002F\u002Fgithub.com\u002FLuisaGroup\u002FLuisaCompute) and [LuisaRender](https:\u002F\u002Fgithub.com\u002FLuisaGroup\u002FLuisaRender): Ray-tracing DSL.\r\n- [Madrona](https:\u002F\u002Fgithub.com\u002Fshacklettbp\u002Fmadrona) and [Madrona-mjx](https:\u002F\u002Fgithub.com\u002Fshacklettbp\u002Fmadrona_mjx): Batch renderer backend\r\n\r\n## Associated Papers\r\n\r\nGenesis is a large scale effort that integrates state-of-the-art technologies of various existing and on-going research work into a single system. Here we include a non-exhaustive list of all the papers that contributed to the Genesis project in one way or another:\r\n\r\n- Xian, Zhou, et al. \"Fluidlab: A differentiable environment for benchmarking complex fluid manipulation.\" arXiv preprint arXiv:2303.02346 (2023).\r\n- Xu, Zhenjia, et al. \"Roboninja: Learning an adaptive cutting policy for multi-material objects.\" arXiv preprint arXiv:2302.11553 (2023).\r\n- Wang, Yufei, et al. \"Robogen: Towards unleashing infinite data for automated robot learning via generative simulation.\" arXiv preprint arXiv:2311.01455 (2023).\r\n- Wang, Tsun-Hsuan, et al. \"Softzoo: A soft robot co-design benchmark for locomotion in diverse environments.\" arXiv preprint arXiv:2303.09555 (2023).\r\n- Wang, Tsun-Hsuan Johnson, et al. \"Diffusebot: Breeding soft robots with physics-augmented generative diffusion models.\" Advances in Neural Information Processing Systems 36 (2023): 44398-44423.\r\n- Katara, Pushkal, Zhou Xian, and Katerina Fragkiadaki. \"Gen2sim: Scaling up robot learning in simulation with generative models.\" 2024 IEEE International Conference on Robotics and Automation (ICRA). IEEE, 2024.\r\n- Si, Zilin, et al. \"DiffTactile: A Physics-based Differentiable Tactile Simulator for Contact-rich Robotic Manipulation.\" arXiv preprint arXiv:2403.08716 (2024).\r\n- Wang, Yian, et al. \"Thin-Shell Object Manipulations With Differentiable Physics Simulations.\" arXiv preprint arXiv:2404.00451 (2024).\r\n- Lin, Chunru, et al. \"UBSoft: A Simulation Platform for Robotic Skill Learning in Unbounded Soft Environments.\" arXiv preprint arXiv:2411.12711 (2024).\r\n- Zhou, Wenyang, et al. \"EMDM: Efficient motion diffusion model for fast and high-quality motion generation.\" European Conference on Computer Vision. Springer, Cham, 2025.\r\n- Qiao, Yi-Ling, Junbang Liang, Vladlen Koltun, and Ming C. Lin. \"Scalable differentiable physics for learning and control.\" International Conference on Machine Learning. PMLR, 2020.\r\n- Qiao, Yi-Ling, Junbang Liang, Vladlen Koltun, and Ming C. Lin. \"Efficient differentiable simulation of articulated bodies.\" In International Conference on Machine Learning, PMLR, 2021.\r\n- Qiao, Yi-Ling, Junbang Liang, Vladlen Koltun, and Ming Lin. \"Differentiable simulation of soft multi-body systems.\" Advances in Neural Information Processing Systems 34 (2021).\r\n- Wan, Weilin, et al. \"Tlcontrol: Trajectory and language control for human motion synthesis.\" arXiv preprint arXiv:2311.17135 (2023).\r\n- Wang, Yian, et al. \"Architect: Generating Vivid and Interactive 3D Scenes with Hierarchical 2D Inpainting.\" arXiv preprint arXiv:2411.09823 (2024).\r\n- Zheng, Shaokun, et al. \"LuisaRender: A high-performance rendering framework with layered and unified interfaces on stream architectures.\" ACM Transactions on Graphics (TOG) 41.6 (2022): 1-19.\r\n- Fan, Yingruo, et al. \"Faceformer: Speech-driven 3d facial animation with transformers.\" Proceedings of the IEEE\u002FCVF Conference on Computer Vision and Pattern Recognition. 2022.\r\n- Wu, Sichun, Kazi Injamamul Haque, and Zerrin Yumak. \"ProbTalk3D: Non-Deterministic Emotion Controllable Speech-Driven 3D Facial Animation Synthesis Using VQ-VAE.\" Proceedings of the 17th ACM SIGGRAPH Conference on Motion, Interaction, and Games. 2024.\r\n- Dou, Zhiyang, et al. \"C· ase: Learning conditional adversarial skill embeddings for physics-based characters.\" SIGGRAPH Asia 2023 Conference Papers. 2023.\r\n\r\n... and many more on-going work.\r\n\r\n## Citation\r\n\r\nIf you use Genesis in your research, please consider citing:\r\n\r\n```bibtex\r\n@misc{Genesis,\r\n  author = {Genesis Authors},\r\n  title = {Genesis: A Generative and Universal Physics Engine for Robotics and Beyond},\r\n  month = {December},\r\n  year = {2024},\r\n  url = {https:\u002F\u002Fgithub.com\u002FGenesis-Embodied-AI\u002FGenesis}\r\n}\r\n","Genesis-Embodied-AI\u002Fgenesis-world 是一个为通用机器人和具身人工智能学习设计的生成式世界。其核心功能包括从零开始重建的通用物理引擎，支持多种材料和物理现象的模拟；轻量级、超快且用户友好的机器人仿真平台；强大的照片级渲染系统；以及能够将自然语言描述转换成多模态数据的生成引擎。这些特性使得 Genesis 适用于需要高精度物理仿真、快速渲染及复杂环境生成的研究与开发场景，如机器人学、具身AI的学习与训练等。项目采用 Python 编写，并在 Apache License 2.0 下开源。",2,"2026-06-11 02:48:38","top_language"]