Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,7 @@
# Genesis

## 🔥 News
- [2025-08-05] Released v0.3.0 🎊 🎉
- [2025-07-02] The development of Genesis is now officially supported by [Genesis AI](https://genesis-ai.company/).
- [2025-01-09] We released a [detailed performance benchmarking and comparison report](https://github.com/zhouxian/genesis-speed-benchmark) on Genesis, together with all the test scripts.
- [2025-01-08] Released v0.2.1 🎊 🎉
Expand Down Expand Up @@ -68,7 +69,6 @@ Project Page: <https://genesis-embodied-ai.github.io/>
- **Compatibility with various robots**: Robotic arms, legged robots, drones, *soft robots*, and support for loading `MJCF (.xml)`, `URDF`, `.obj`, `.glb`, `.ply`, `.stl`, and more.
- **Photo-realistic rendering**: Native ray-tracing-based rendering.
- **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).
- **Physics-based tactile simulation**: Differentiable [tactile sensor simulation](https://github.com/Genesis-Embodied-AI/DiffTactile) coming soon (expected in version 0.3.0).
- **User-friendliness**: Designed for simplicity, with intuitive installation and APIs.

## Quick Installation
Expand Down
72 changes: 62 additions & 10 deletions README_CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,16 @@

# Genesis 通用物理引擎

## 🔥 最新消息

- [2025-08-05] 发布 v0.3.0 🎊 🎉
- [2025-07-02] Genesis 的开发工作现已获得 [Genesis AI](https://genesis-ai.company/) 的官方支持。
- [2025-01-09] 我们发布了一份关于 Genesis 的[详细性能基准测试和比较报告](https://github.com/zhouxian/genesis-speed-benchmark),并附上所有测试脚本。
- [2025-01-08] 发布 v0.2.1 🎊 🎉
- [2025-01-08] 创建了 [Discord](https://discord.gg/nukCuhB47p) 和 [微信](https://drive.google.com/uc?export=view&id=1ZS9nnbQ-t1IwkzJlENBYqYIIOOZhXuBZ) 社区群。
- [2024-12-25] 添加了支持光线追踪渲染器的 [docker](https://www.google.com/search?q=%23docker)。
- [2024-12-24] 添加了[为 Genesis 做贡献](https://github.com/Genesis-Embodied-AI/Genesis/blob/main/.github/CONTRIBUTING.md)的指南。

## 目录

1. [概述](#概述)
Expand Down Expand Up @@ -54,31 +64,47 @@ Genesis 是专为 *机器人/嵌入式 AI/物理 AI* 应用设计的通用物理
- **支持广泛的机器人**:机器人手臂、腿式机器人、无人机、*软体机器人*等,并广泛支持加载不同文件类型:`MJCF (.xml)`、`URDF`、`.obj`、`.glb`、`.ply`、`.stl` 等。
- **照片级真实感和高性能光线追踪器**:Genesis 支持基于光线追踪的原生渲染。
- **可微分性**:Genesis 设计为完全兼容可微分模拟。目前,我们的 MPM 求解器和工具求解器是可微分的,其他求解器的可微分性将很快添加(从刚体模拟开始)。
- **基于物理的触觉传感器**:Genesis 包含一个基于物理的可微分 [触觉传感器模拟模块](https://github.com/Genesis-Embodied-AI/DiffTactile)。这将很快集成到公共版本中(预计在 0.3.0 版本中)。
- **用户友好性**:Genesis 设计为尽可能简化模拟的使用。从安装到 API 设计,如果有任何您觉得不直观或难以使用的地方,请 [告诉我们](https://github.com/Genesis-Embodied-AI/Genesis/issues)。

## 快速入门

### 安装
首先按照[官方指南](https://pytorch.org/get-started/locally/)安装 PyTorch。
## 快速安装

首先,请根据[官方指南](https://pytorch.org/get-started/locally/)安装 **PyTorch**。

然后,通过 PyPI 安装 Genesis:

然后可通过 PyPI 安装Genesis:
```bash
pip install genesis-world # 需要 Python >=3.9
pip install genesis-world # 要求 Python>=3.10,<3.14;
```

### Docker 支持
要安装最新的版本,请先通过 `pip install --upgrade pip` 命令确保 `pip` 是最新版本,然后运行以下命令:

如果您想通过 Docker 使用 Genesis,您可以首先构建 Docker 镜像,命令如下:
```bash
pip install git+https://github.com/Genesis-Embodied-AI/Genesis.git
```

请注意,您仍需手动更新此软件包以与主分支保持同步。

如果用户希望编辑 Genesis 的源代码,我们鼓励以可编辑模式安装。首先,请确保已卸载 `genesis-world`,然后克隆代码仓库并在本地安装:

```bash
git clone https://github.com/Genesis-Embodied-AI/Genesis.git
cd Genesis
pip install -e ".[dev]"
```

## Docker

如果您希望通过 Docker 使用 Genesis,可以先像这样构建 Docker 镜像:

```bash
docker build -t genesis -f docker/Dockerfile docker
```

然后,您可以在 Docker 镜像内运行示例代码(挂载到 `/workspace/examples`):
然后您可以在 Docker 镜像中运行示例(示例文件挂载于 `/workspace/examples`):

```bash
xhost +local:root # 允许容器访问显示器
xhost +local:root # 允许容器访问显示设备

docker run --gpus all --rm -it \
-e DISPLAY=$DISPLAY \
Expand All @@ -88,6 +114,32 @@ docker run --gpus all --rm -it \
genesis
```

### AMD 用户

AMD 用户可以使用 `docker/Dockerfile.amdgpu` 文件来使用 Genesis,该文件可通过运行以下命令构建:

```
docker build -t genesis-amd -f docker/Dockerfile.amdgpu docker
```

然后通过运行以下命令来使用:

```xhost +local:docker \
docker run -it --network=host \
--device=/dev/kfd \
--device=/dev/dri \
--group-add=video \
--ipc=host \
--cap-add=SYS_PTRACE \
--security-opt seccomp=unconfined \
--shm-size 8G \
-v $PWD:/workspace \
-e DISPLAY=$DISPLAY \
genesis-amd
```

示例文件将可以在 `/workspace/examples` 目录下找到。注意:AMD 用户应使用 Vulkan 后端。这意味着您需要调用 `gs.init(vulkan)` 来初始化 Genesis。

### 文档

- [英文文档](https://genesis-world.readthedocs.io/en/latest/user_guide/index.html)
Expand Down
52 changes: 42 additions & 10 deletions README_FR.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,8 +19,13 @@

## 🔥 Nouveautés

- [2024-12-25] Ajout d’un [docker](#docker) incluant la prise en charge du moteur de rendu par ray-tracing.
- [2024-12-24] Ajout de directives pour [contribuer à Genesis](https://github.com/Genesis-Embodied-AI/Genesis/blob/main/.github/CONTRIBUTING.md).
- [2025-08-05] Sortie de la v0.3.0 🎊 🎉
- [2025-07-02] Le développement de Genesis est désormais officiellement soutenu par [Genesis AI](https://genesis-ai.company/).
- [2025-01-09] Nous avons publié un [rapport détaillé d'analyse comparative des performances](https://github.com/zhouxian/genesis-speed-benchmark) de Genesis, accompagné de tous les scripts de test.
- [2025-01-08] Sortie de la v0.2.1 🎊 🎉
- [2025-01-08] Création des groupes [Discord](https://discord.gg/nukCuhB47p) et [Wechat](https://drive.google.com/uc?export=view&id=1ZS9nnbQ-t1IwkzJlENBYqYIIOOZhXuBZ).
- [2024-12-25] Ajout d’un [docker](https://www.google.com/search?q=%23docker) incluant la prise en charge du moteur de rendu par lancer de rayon (ray-tracing).
- [2024-12-24] Ajout de directives pour [contribuer à Genesis](https://github.com/Genesis-Embodied-AI/Genesis/blob/main/.github/CONTRIBUTING.md).

## Table des Matières

Expand Down Expand Up @@ -61,26 +66,28 @@ Page du projet : <https://genesis-embodied-ai.github.io/>
- **Compatibilité avec divers robots** : Bras robotiques, robots à pattes, drones, *robots mous*, et support pour charger `MJCF (.xml)`, `URDF`, `.obj`, `.glb`, `.ply`, `.stl`, et plus encore.
- **Rendu photo-réaliste** : Rendu natif basé sur le lancer de rayons.
- **Différentiabilité** : Genesis est conçu pour être entièrement différentiable. Actuellement, notre solveur MPM et Tool Solver prennent en charge la différentiabilité, avec d'autres solveurs prévus dans les prochaines versions (à commencer par le solveur de corps rigides et articulés).
- **Simulation tactile basée sur la physique** : Simulation de capteur tactile différentiable [en cours de développement](https://github.com/Genesis-Embodied-AI/DiffTactile) (prévue pour la version 0.3.0).
- **Facilité d'utilisation** : Conçu pour être simple, avec une installation intuitive et des API conviviales.

## Installation Rapide

Genesis est disponible via PyPI :
Installez d'abord **PyTorch** en suivant les [instructions officielles](https://pytorch.org/get-started/locally/).

Ensuite, installez Genesis via PyPI :

```bash
pip install genesis-world # Nécessite Python>=3.10,<3.14;
```

Vous devez également installer **PyTorch** en suivant [les instructions officielles](https://pytorch.org/get-started/locally/).
Pour obtenir la version la plus récente, assurez-vous que `pip` est à jour via `pip install --upgrade pip`, puis exécutez la commande :

Pour la dernière version disponible à ce jour, assurez-vous que `pip` is à jour via `pip install --upgrade pip`, puis executez la commande:
```bash
pip install git+https://github.com/Genesis-Embodied-AI/Genesis.git
```
A noter que le module doit malgré tout être mis à jour manuellement pour rester synchroniser avec la branche principale.

Les utilisateur souhaitant éditer le code source de Genesis sont encouragés à l'installer en mode developpeur/éditable. Assurez vous que `genesis-world` est bien désinstallée, puis clonez le dépôt et installez localement :
Notez que le paquet doit toujours être mis à jour manuellement pour se synchroniser avec la branche principale (main).

Les utilisateurs souhaitant modifier le code source de Genesis sont encouragés à l'installer en mode éditable. D'abord, assurez-vous que `genesis-world` a été désinstallé, puis clonez le dépôt et installez-le localement :

```bash
git clone https://github.com/Genesis-Embodied-AI/Genesis.git
cd Genesis
Expand All @@ -89,13 +96,13 @@ pip install -e ".[dev]"

## Docker

Si vous souhaitez utiliser Genesis avec Docker, vous pouvez d'abord construire l'image Docker comme suit :
Si vous souhaitez utiliser Genesis depuis Docker, vous pouvez d'abord construire l'image Docker comme suit :

```bash
docker build -t genesis -f docker/Dockerfile docker
```

Ensuite, vous pouvez exécuter les exemples à l'intérieur de l'image Docker (montés sur `/workspace/examples`) :
Vous pouvez ensuite exécuter les exemples à l'intérieur de l'image Docker (montés dans `/workspace/examples`) :

```bash
xhost +local:root # Autoriser le conteneur à accéder à l'affichage
Expand All @@ -106,9 +113,34 @@ docker run --gpus all --rm -it \
-v /tmp/.X11-unix/:/tmp/.X11-unix \
-v $PWD:/workspace \
genesis
```

### Utilisateurs AMD

Les utilisateurs AMD peuvent utiliser Genesis avec le fichier `docker/Dockerfile.amdgpu`, qui se construit en exécutant :

```
docker build -t genesis-amd -f docker/Dockerfile.amdgpu docker
```

et peut ensuite être utilisé en exécutant :

```xhost +local:docker \
docker run -it --network=host \
--device=/dev/kfd \
--device=/dev/dri \
--group-add=video \
--ipc=host \
--cap-add=SYS_PTRACE \
--security-opt seccomp=unconfined \
--shm-size 8G \
-v $PWD:/workspace \
-e DISPLAY=$DISPLAY \
genesis-amd
```

Les exemples seront accessibles depuis `/workspace/examples`. Note : Les utilisateurs AMD doivent utiliser le backend Vulkan. Cela signifie que vous devrez appeler `gs.init(vulkan)` pour initialiser Genesis.

## Documentation

Une documentation complète est disponible en [Anglais](https://genesis-world.readthedocs.io/en/latest/user_guide/index.html) et en [Chinois](https://genesis-world.readthedocs.io/zh-cn/latest/user_guide/index.html). Cela inclut des étapes d'installation détaillées, des tutoriels et des références API.
Expand Down
57 changes: 44 additions & 13 deletions README_JA.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,8 +19,13 @@

## 🔥 最新情報

- [2024-12-25] [レイトレーシングレンダラー](#docker)をサポートするDockerを追加しました。
- [2024-12-24] [Genesisへの貢献方法](https://github.com/Genesis-Embodied-AI/Genesis/blob/main/.github/CONTRIBUTING.md)に関するガイドラインを追加しました。
- [2025-08-05] v0.3.0をリリースしました 🎊 🎉
- [2025-07-02] Genesisの開発が、[Genesis AI](https://genesis-ai.company/)によって公式にサポートされることになりました。
- [2025-01-09] Genesisに関する[詳細なパフォーマンスベンチマークと比較レポート](https://github.com/zhouxian/genesis-speed-benchmark)を、すべてのテストスクリプトと共に公開しました。
- [2025-01-08] v0.2.1をリリースしました 🎊 🎉
- [2025-01-08] [Discord](https://discord.gg/nukCuhB47p)[Wechat](https://drive.google.com/uc?export=view&id=1ZS9nnbQ-t1IwkzJlENBYqYIIOOZhXuBZ)のグループを作成しました。
- [2024-12-25] レイトレーシングレンダラーをサポートする[docker](https://www.google.com/search?q=%23docker)を追加しました。
- [2024-12-24] [Genesisへの貢献](https://github.com/Genesis-Embodied-AI/Genesis/blob/main/.github/CONTRIBUTING.md)に関するガイドラインを追加しました。

## 目次

Expand Down Expand Up @@ -61,28 +66,27 @@ Genesisの目指すところ:
- **様々なロボットへの対応**: ロボットアーム、脚付きロボット、ドローン、*ソフトロボット*など。また、`MJCF (.xml)``URDF``.obj``.glb``.ply``.stl`などの形式をサポート。
- **フォトリアルなレンダリング**: レイトレーシングベースのレンダリングをネイティブでサポート。
- **微分可能性**: 完全な微分可能性を備えた設計。現時点では、MPMソルバーとツールソルバーが対応しており、将来的には他のソルバーも対応予定(まず剛体および連結体ソルバーから開始)。
- **物理ベースの触覚シミュレーション**: 微分可能な[触覚センサーシミュレーション](https://github.com/Genesis-Embodied-AI/DiffTactile)が近日公開予定(バージョン0.3.0を予定)。
- **ユーザーフレンドリー**: シンプルで直感的なインストールとAPI設計。

## インストール

GenesisはPyPIで利用可能です:
まず[公式の手順](https://pytorch.org/get-started/locally/)に従って**PyTorch**をインストールしてください。

次に、PyPI経由でGenesisをインストールします:

```bash
pip install genesis-world # Python>=3.10,<3.14 が必要です;
pip install genesis-world # Python>=3.10,<3.14が必要です;
```

また、**PyTorch**[公式手順](https://pytorch.org/get-started/locally/)に従ってインストールする必要があります。

最新版を利用する場合はこのレポジトリから直接インストールしてください:
最新バージョンを利用するには、`pip install --upgrade pip``pip`を更新してから、次のコマンドを実行してください:

```bash
pip install git+https://github.com/Genesis-Embodied-AI/Genesis.git
```

このパッケージは定期的に手動で最新版と同期する必要があることに注意してください
注意:mainブランチと同期するには、パッケージを手動で更新する必要があります

ソースコードを変更したいユーザはGenesisを開発者モードでインストールすることを推奨します。まず、pip経由の `genesis-world` がアンインストールされていることを確認してください。そして、このレポジトリーを以下のようにクローンしてインストールしてください。
Genesisのソースコードを編集したいユーザーは、編集可能モードでGenesisをインストールすることを推奨します。まず、`genesis-world`がアンインストールされていることを確認し、リポジトリをクローンしてローカルにインストールします:

```bash
git clone https://github.com/Genesis-Embodied-AI/Genesis.git
Expand All @@ -92,16 +96,16 @@ pip install -e ".[dev]"

## Docker

DockerからGenesisを利用する場合は、まずDockerイメージをビルドします
DockerからGenesisを使用したい場合は、まず次のようにしてDockerイメージをビルドできます

```bash
docker build -t genesis -f docker/Dockerfile docker
```

その後、Dockerイメージ内で例を実行できます`/workspace/examples`にマウント):
その後、Dockerイメージ内でサンプルを実行できます`/workspace/examples`にマウントされます):

```bash
xhost +local:root # コンテナがディスプレイにアクセスできるようにする
xhost +local:root # コンテナがディスプレイにアクセスすることを許可

docker run --gpus all --rm -it \
-e DISPLAY=$DISPLAY \
Expand All @@ -111,6 +115,33 @@ docker run --gpus all --rm -it \
genesis
```

### AMDユーザー

AMDユーザーは、`docker/Dockerfile.amdgpu`ファイルを使ってGenesisを利用できます。これは次のコマンドを実行してビルドします:

```
docker build -t genesis-amd -f docker/Dockerfile.amdgpu docker
```

ビルド後、次のコマンドを実行して使用できます:

```
xhost +local:docker \
docker run -it --network=host \
--device=/dev/kfd \
--device=/dev/dri \
--group-add=video \
--ipc=host \
--cap-add=SYS_PTRACE \
--security-opt seccomp=unconfined \
--shm-size 8G \
-v $PWD:/workspace \
-e DISPLAY=$DISPLAY \
genesis-amd
```

サンプルは`/workspace/examples`からアクセス可能です。注意:AMDユーザーはVulkanバックエンドを使用してください。これは、Genesisを初期化するために`gs.init(vulkan)`を呼び出す必要があることを意味します。

## ドキュメント

包括的なドキュメントは現時点では[英語](https://genesis-world.readthedocs.io/en/latest/user_guide/index.html)[中国語](https://genesis-world.readthedocs.io/zh-cn/latest/user_guide/index.html)、および[日本語](https://genesis-world.readthedocs.io/ja/latest/user_guide/index.html)で提供されています。詳細なインストール手順、チュートリアル、APIリファレンスが含まれています。
Expand Down
Loading