Metadata-Version: 2.4
Name: xorl
Version: 0.1.1
Summary: eXtensible Orchestration for Reinforcement Learning
Author: Qingyang Wu
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/qywu/xorl
Project-URL: Repository, https://github.com/qywu/xorl
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: torch>=2.0
Requires-Dist: numpy
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: ruff; extra == "dev"

# xorl

eXtensible Orchestration for Reinforcement Learning — a lightweight infrastructure for RL training.

## Features

- **TrainConfig** — dataclass-based configuration for RL hyperparameters (PPO-style: gamma, GAE, clipping, etc.)
- **Trainer** — base trainer with optimizer setup, checkpointing, and training loop
- **Utilities** — seed management, gradient norm computation, parameter counting

## Installation

```bash
pip install xorl
```

## Quick Start

```python
from turl import TrainConfig, Trainer

config = TrainConfig(
    lr=3e-4,
    batch_size=64,
    gamma=0.99,
    clip_range=0.2,
)
```

## License

Apache-2.0
