# Ambientes

Os ambientes de simulação são configurados por meio de `EnvConfig` e construídos por `make_env`. Cada subclasse declara seus `gym_kwargs` e como construir os ambientes vetorizados.

Veja [Environments from the Hub](../envhub) para usar ambientes publicados e [Adding a New Benchmark](../adding_benchmarks) para contribuir com um.

## EnvConfig[[lerobot.envs.EnvConfig]]

#### lerobot.envs.EnvConfig[[lerobot.envs.EnvConfig]]

```python
lerobot.envs.EnvConfig(task: str | None = None, fps: int = 30, features: dict[str, PolicyFeature] = <factory>, features_map: dict[str, str] = <factory>, max_parallel_tasks: int = 1, disable_env_checker: bool = True, server: EnvClientConfig | None = None)
```

[Fonte](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/envs/configs.py#L71)

#### create_env[[lerobot.envs.EnvConfig.create_env]]

```python
create_env(task_group: str | None = None, task_id: int | None = None, n_envs: int = 1, use_async_envs: bool = False)
```

[Fonte](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/envs/configs.py#L127)

Crie um env de vetores local ou servido para uma tarefa; a ausência de `task_id` significa a primeira tarefa da suíte.

#### create_envs[[lerobot.envs.EnvConfig.create_envs]]

```python
create_envs(n_envs: int, use_async_envs: bool = False)
```

[Fonte](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/envs/configs.py#L112)

Crie envs de vetores locais ou servidos, como `&amp;lcub;suite: &amp;lcub;task_id: env}}`.

#### get_env_processors[[lerobot.envs.EnvConfig.get_env_processors]]

```python
get_env_processors()
```

[Fonte](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/envs/configs.py#L215)

Return (preprocessor, postprocessor) para este env. Padrão: identity.

#### sim_config[[lerobot.envs.EnvConfig.sim_config]]

```python
sim_config()
```

[Fonte](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/envs/configs.py#L108)

Retorne `sim_settings()` com os padrões da simulação, como os ambientes locais e o servidor de ambiente o executam.

#### sim_settings[[lerobot.envs.EnvConfig.sim_settings]]

```python
sim_settings()
```

[Fonte](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/envs/configs.py#L101)

Retorna as configurações de simulação, como na seção `sim` de um YAML de servidor; as ausentes usam os padrões de simulação.

O padrão é o ambiente Gymnasium `gym_id` com `gym_kwargs` e ações delta; substitua caso contrário.

## make_env[[lerobot.envs.make_env]]

#### lerobot.envs.make_env[[lerobot.envs.make_env]]

```python
lerobot.envs.make_env(cfg: EnvConfig | str, n_envs: int = 1, use_async_envs: bool = False, hub_cache_dir: str | None = None, trust_remote_code: bool = False)
```

[Fonte](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/envs/factory.py#L65)

**Parâmetros:**

cfg (`EnvConfig | str`) : A configuração do ambiente, ou um ID de repositório do Hugging Face Hub (por exemplo, `"username/repo"`) cujo `env.py` constrói os ambientes.

n_envs (`int`, *opcional*, padrão `1`) : Número de ambientes em cada vetor de ambientes.

use_async_envs (`bool`, *opcional*, padrão `False`) : Executa cada ambiente em seu próprio processo de worker.

hub_cache_dir (`str`, *opcional*) : Pasta para armazenar em cache o `env.py` baixado. Usado apenas com um ID de repositório.

trust_remote_code (`bool`, *opcional*, padrão `False`) : Consentimento para executar o código de um repositório do Hub, necessário para um ID de repositório ou uma configuração do EnvHub.

**Retorna:** `dict[str, dict[int, gym.vector.VectorEnv]]`

Os ambientes vetoriais, como `{suite: {task_id: env}}`. Um ambiente de tarefa única tem um único suite, com ID de tarefa 0.

**Exceções:** ``ValueError`` ou ``RuntimeError`` ou ``ModuleNotFoundError``

- ``ValueError`` -- Se `n_envs` for menor que 1.
- ``RuntimeError`` -- Se o código de um repositório do Hub fosse executado sem `trust_remote_code`.
- ``ModuleNotFoundError`` -- Se o simulador, ou um pacote necessário pelo `env.py` do repositório, não estiver instalado.

Construa os ambientes vetoriais de uma configuração ou do `make_env` de um repositório do Hub.

## make_env_config[[lerobot.envs.make_env_config]]

#### lerobot.envs.make_env_config[[lerobot.envs.make_env_config]]

```python
lerobot.envs.make_env_config(env_type: str, **kwargs)
```

[Fonte](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/envs/factory.py#L27)

