Skip to content

Repository files navigation

Deep Reinforcement Learning

Python 3.12+ PyTorch Gymnasium Development License: MIT

This project builds a PyTorch reinforcement learning library from the mathematics outward. Algorithms are developed as a complete path from the objective and estimator to the data flow and parameter update.

The implemented on-policy stack runs from one-step actor-critic through PPO. DQN and Double DQN are the current implementation focus. The longer direction includes continuous and offline RL, imitation and model-based learning, Gymnasium and MuJoCo benchmarks, and robotics policy deployment.

Active development: Public APIs may change while shared training components and benchmark interfaces are stabilized.

Algorithms

On-Policy Optimization (Implemented)

Off-Policy Learning (In Development)

From Derivations to Systems

The derivations are working specifications for the code. They determine what the buffers preserve, where gradients stop, which quantities remain fixed during an update, and how training is divided into reusable components. This is visible in boundary-correct GAE, old-policy handling in PPO, matrix-free Fisher products, and TRPO's parameter rollback.

DQN is the current off-policy implementation target. Its derivation separates generalized Q-learning into independently scheduled data collection, target-network refresh, and Q-function fitting. That decomposition defines the off-policy system now being built.

An agent performing generalized Q-learning through data collection, target-network refresh, and Q-function fitting

Browse all mathematical derivations

Development Setup

Python 3.12 or later is required. Dependencies are managed with uv.

git clone https://github.com/SaiSampathKedari/Deep-Reinforcement-Learning.git
cd Deep-Reinforcement-Learning
uv sync

Roadmap

Now: DQN, Double DQN, and the shared replay and Q-learning system.

Next: Reusable policy, value, and Q-function interfaces; configurable optimizers; DDPG, TD3, SAC; and multi-seed Gymnasium and MuJoCo benchmarks.

Later: Offline RL, imitation learning, model-based RL, richer policy architectures, real-robot deployment, and VLA post-training.

Related Repositories

Contact

License

Released under the MIT License.

About

Deep Reinforcement Learning from mathematical foundations to PyTorch implementations: rigorous proofs, step-by-step derivations of objectives and gradient estimators, and reproducible experiments on Gymnasium and MuJoCo benchmarks spanning policy gradients, actor-critic methods, value-based learning, and continuous control.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages