.. include:: /_includes/rllib/we_are_hiring.rst

.. include:: /_includes/rllib/new_api_stack.rst

.. include:: /_includes/rllib/new_api_stack_component.rst

.. _rlmodule-reference-docs:

RLModule API
============


RL Module specifications and configurations
-------------------------------------------

Single Agent
++++++++++++

.. currentmodule:: ray.rllib.core.rl_module.rl_module

.. autosummary::
    :nosignatures:
    :toctree: doc/

    SingleAgentRLModuleSpec
    SingleAgentRLModuleSpec.build
    SingleAgentRLModuleSpec.get_rl_module_config

RLModule Configuration
+++++++++++++++++++++++

.. autosummary::
    :nosignatures:
    :toctree: doc/

    RLModuleConfig
    RLModuleConfig.to_dict
    RLModuleConfig.from_dict
    RLModuleConfig.get_catalog

Multi Agent
++++++++++++

.. currentmodule:: ray.rllib.core.rl_module.marl_module

.. autosummary::
    :nosignatures:
    :toctree: doc/

    MultiAgentRLModuleSpec
    MultiAgentRLModuleSpec.build
    MultiAgentRLModuleSpec.get_marl_config



RL Module API
-------------

.. currentmodule:: ray.rllib.core.rl_module.rl_module


Constructor
+++++++++++

.. autosummary::
    :nosignatures:
    :toctree: doc/

    RLModule
    RLModule.as_multi_agent


Forward methods
+++++++++++++++

.. autosummary::
    :nosignatures:
    :toctree: doc/


    ~RLModule.forward_train
    ~RLModule.forward_exploration
    ~RLModule.forward_inference

IO specifications
+++++++++++++++++

.. autosummary::
    :nosignatures:
    :toctree: doc/

    ~RLModule.input_specs_inference
    ~RLModule.input_specs_exploration
    ~RLModule.input_specs_train
    ~RLModule.output_specs_inference
    ~RLModule.output_specs_exploration
    ~RLModule.output_specs_train



Saving and Loading
++++++++++++++++++++++

.. autosummary::
    :nosignatures:
    :toctree: doc/

    ~RLModule.get_state
    ~RLModule.set_state
    ~RLModule.save_state
    ~RLModule.load_state
    ~RLModule.save_to_checkpoint
    ~RLModule.from_checkpoint


Multi Agent RL Module API
-------------------------

.. currentmodule:: ray.rllib.core.rl_module.marl_module

Constructor
+++++++++++

.. autosummary::
    :nosignatures:
    :toctree: doc/

    MultiAgentRLModule
    MultiAgentRLModule.setup
    MultiAgentRLModule.as_multi_agent

Modifying the underlying RL modules
++++++++++++++++++++++++++++++++++++

.. autosummary::
    :nosignatures:
    :toctree: doc/

    ~MultiAgentRLModule.add_module
    ~MultiAgentRLModule.remove_module

Saving and Loading
++++++++++++++++++++++

.. autosummary::
    :nosignatures:
    :toctree: doc/

    ~MultiAgentRLModule.save_state
    ~MultiAgentRLModule.load_state