Metadata-Version: 2.4
Name: icland
Version: 0.1.0a1
Summary: Recreating Google DeepMind's XLand RL environment in JAX
License-File: LICENSE
Requires-Python: >=3.13
Requires-Dist: beartype>=0.19.0
Requires-Dist: brax>=0.12.1
Requires-Dist: flax>=0.10.2
Requires-Dist: gputil>=1.4.0
Requires-Dist: hilbertcurve>=2
Requires-Dist: imageio[ffmpeg]>=2.37.0
Requires-Dist: jax>=0.5.0; sys_platform != 'linux'
Requires-Dist: jax[cuda12]>=0.5.0; sys_platform == 'linux'
Requires-Dist: jaxtyping>=0.2.37
Requires-Dist: keyboard>=0.13.5
Requires-Dist: matplotlib>=3.10.0
Requires-Dist: mujoco-mjx>=3.2.6
Requires-Dist: mujoco>=3.2.6
Requires-Dist: numpy-stl>=3.2.0
Requires-Dist: numpy>=2.2.2
Requires-Dist: opencv-python>=4.11.0.86
Requires-Dist: py-cpuinfo>=9.0.0
Requires-Dist: pylatex>=1.4.2
Requires-Dist: pynvml>=12.0.0
Requires-Dist: scipy>=1.15.1
Requires-Dist: types-setuptools>=75.8.0.20250110
Description-Content-Type: text/markdown

# ICLand

[![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/lysj-cpu/icland/tests.yml?style=flat-square)](https://github.com/lysj-cpu/icland/actions/workflows/tests.yml)
[![Codecov](https://img.shields.io/codecov/c/github/lysj-cpu/icland?style=flat-square)](https://app.codecov.io/github/lysj-cpu/icland)

## Development Instructions

Clone the project locally:

```shell
$ git clone git@github.com:lysj-cpu/icland.git
$ cd icland
```

### uv (recommended)

The project can be run via [uv](https://docs.astral.sh/uv/):

```shell
$ uv run python -c "import icland; print(icland.__doc__)"
Recreating Google DeepMind's XLand RL environment in JAX.
```

[Ruff](https://docs.astral.sh/ruff/) is used for formatting.

```shell
$ uv run ruff check   # Linting
$ uv run ruff format  # Formatting
```

You can also install [pre-commit](https://pre-commit.com/) hooks to automatically run validation checks when making a commit:

```shell
$ uv run pre-commit install
```

### pip

`uv` is [preferred](https://docs.astral.sh/uv/#highlights) over pip and also installs developer dependencies. However, pip might still be useful for small modifications.

First, we create and activate a [virtual environment](https://docs.python.org/3/library/venv.html):

```shell
$ python -m venv env
$ source env/bin/activate
```


Then install in [editable mode](https://pip.pypa.io/en/stable/topics/local-project-installs/#editable-installs):

```shell
$ pip install -e .
$ python -c "import icland; print(icland.__doc__)"
Recreating Google DeepMind's XLand RL environment in JAX.
```
