python-redmine travis-ci python

Python Redmine is a library for communicating with a Redmine project management application

Python Redmine

.. image:: :target:

.. image:: :target:

.. image:: :target:

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

.. code-block:: python

>>> from redmine 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
<redmine.resultsets.ResourceSet object with Issue resources>

>>> project.issues[0]
<redmine.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
<redmine.resultsets.ResourceSet object with TimeEntry resources>


  • Supports 100% of Redmine API features
  • Supports Python 2.6 - 3.5, PyPy and PyPy3
  • Extensively documented
  • Provides ORM-style Pythonic API


To install Python Redmine, simply:

.. code-block:: bash

$ pip install python-redmine


.. code-block:: bash

$ easy_install python-redmine


Documentation is available at

Contacts and Support

I will be glad to get your feedback, pull requests <>, issues <>, whatever. Feel free to contact me for any questions.

Donations and Sponsorship

If you like this project and want to support it you have 3 options:

#. Just give this project a star at the top of the GitHub <>_ repository. That doesn’t cost you anything but makes the author <>_ happier. #. You can express your gratitude via Gratipay <>_. #. Become a sponsor. Contact me via tepkeev at gmail dot com if you are interested in becoming a sponsor and we will discuss the terms and conditions.

Copyright and License

Python Redmine is licensed under Apache 2.0 license. Check the LICENSE <>_ for details.

Related Repositories



Python Redmine is a library for communicating with a Redmine project management application ...



Python Redmine Web Services Library ...



Python script to export Redmine ( issues into OmniFocus ( projects ...



Python script to upload files to the 'Files' section in a Redmine project. ...



Redmine API for Python ...

Top Contributors

maxtepkeev andreiavram s3rvac loechel Digenis rconradharris 0x55aa aaloy bdrung Galaf hsum uSpike


-   v1.5.1 zip tar
-   v1.5.0 zip tar
-   v1.4.0 zip tar
-   v1.3.0 zip tar
-   v1.2.0 zip tar
-   v1.1.2 zip tar
-   v1.1.1 zip tar
-   v1.1.0 zip tar
-   v1.0.3 zip tar
-   v1.0.2 zip tar
-   v1.0.1 zip tar
-   v1.0.0 zip tar
-   v0.9.0 zip tar
-   v0.8.4 zip tar
-   v0.8.3 zip tar
-   v0.8.2 zip tar
-   v0.8.1 zip tar
-   v0.8.0 zip tar
-   v0.7.2 zip tar
-   v0.7.1 zip tar
-   v0.7.0 zip tar
-   v0.6.2 zip tar
-   v0.6.1 zip tar
-   v0.6.0 zip tar
-   v0.5.0 zip tar
-   v0.4.0 zip tar
-   v0.3.1 zip tar
-   v0.3.0 zip tar
-   v0.2.0 zip tar
-   v0.1.1 zip tar