thu-ml/tianshou

An elegant PyTorch deep reinforcement learning library.

View on GitHub ↗Jump to charts ↓

Summary Information

Updated 40 minutes ago
Added to GitGenius on September 5th, 2026
Created on April 16th, 2018
Open Issues & Pull Requests: 139 (+0)
GitHub issues: Enabled
Number of forks: 1,336
Total Stargazers: 10,960 (+0)
Total Subscribers: 98 (+0)

Repository Insights (GitGenius)

Median issue/PR response: 2.1 days
Mean response time: 70.7 days
90th percentile: 121.8 days
Tracked items: 65

How this project is maintained

Around half of the issues opened in the past year never receive a reply. 85% of open issues come from outside the core team, so the backlog reflects real-world use rather than internal planning. Only 6% of issues opened in the past year have been closed. Three people close 88% of everything that gets resolved.

Charts & Analytics

Fetching additional details & charts...

Issue Activity (beta)

Open issues: 33
New in 7 days: 0
Closed in 7 days: 0
Avg open age: 571 days
Stale 30+ days: 31
Stale 90+ days: 30

Recent activity

Opened in 7 days: 0
Closed in 7 days: 0
Comments in 7 days: 0
Events in 7 days: 0

Top labels

  • refactoring (10)
  • good first issue (8)
  • breaking changes (6)
  • major (6)
  • question (6)
  • documentation (5)
  • enhancement (5)
  • bug (4)

Most active issues this week

No issue events were indexed in the last 7 days.

Detailed Description

Tianshou is a deep reinforcement learning library built on PyTorch that provides both low-level interfaces for algorithm research and high-level interfaces for practical application.

The library addresses the need for a flexible, performant framework that unifies diverse RL paradigms. It separates learning algorithms from policies through distinct abstractions, establishing clear type-level distinctions between on-policy, off-policy, and offline algorithms. This modular design allows researchers to implement custom algorithms while enabling practitioners to train existing algorithms on custom environments without deep framework knowledge.

Tianshou suits teams building production RL systems or conducting algorithm research where code clarity and extensibility matter. The library's scope spans online reinforcement learning, offline RL, experimental multi-agent RL support, and model-based approaches, making it appropriate for projects that may evolve across these domains. Practitioners should note that the library underwent a major redesign that breaks backward compatibility with earlier versions, requiring migration effort for existing codebases but establishing clearer, more consistent interfaces going forward.

The project maintains active development with regular refinements to its core abstractions and documentation. The codebase shows sustained attention to API design, with parameter naming and class hierarchies revised for intuitiveness. The library receives ongoing updates to support contemporary RL research directions, including experimental features for emerging areas like multi-agent systems and model-based methods.