Python-Redmine is a library for communicating with a Redmine project management application. Redmine exposes some data via REST API for which Python-Redmine provides simple but powerful Pythonic API inspired by a well-known Django ORM:

>>> from redminelib import Redmine

>>> redmine = Redmine('', username='foo', password='bar')
>>> project = redmine.project.get('vacation')


>>> project.identifier

>>> project.created_on
datetime.datetime(2013, 12, 31, 13, 27, 47)

>>> project.issues
<redminelib.resultsets.ResourceSet object with Issue resources>

>>> project.issues[0]
<redminelib.resources.Issue #34441 "Vacation">

>>> dir(project.issues[0])
['assigned_to', 'author', 'created_on', 'description', 'done_ratio',
'due_date', 'estimated_hours', 'id', 'priority', 'project', 'relations',
'start_date', 'status', 'subject', 'time_entries', 'tracker', 'updated_on']

>>> project.issues[0].subject

>>> project.issues[0].time_entries
<redminelib.resultsets.ResourceSet object with TimeEntry resources>


  • Supports 100% of Redmine API
  • Supports external Redmine plugins API
  • Supports Python 2.6, 2.7, 3.3 - 3.6, PyPy and PyPy3
  • Supports different request engines
  • Extendable via custom resources and custom request engines
  • Extensively documented
  • Provides ORM-style Pythonic API
  • And many more…

Contacts and Support

Support for Standard Edition is provided via GitHub only, while support for Pro Edition is provided both via GitHub and Be sure to write from email that was specified during the purchase procedure.

Table of contents