---
id: python-redmine
version: "2.5.0"
license: Apache 2.0
license_treatment: permissive
maintenance: dormant
---

# python-redmine — Library for communicating with a Redmine project management application

License: permissive · Maintenance: dormant · Downloads: 195.7K/mo

## What it is and what it does

Python-Redmine is a client library that wraps Redmine's REST API in a Pythonic, ORM-inspired interface. It lets you query, create, update, and delete Redmine resources—projects, issues, users, time entries, and more—using familiar object-oriented patterns rather than raw HTTP calls. The library depends only on requests and supports Python 3.7 through 3.12 and PyPy3.

It's designed for developers who need to automate Redmine workflows, integrate Redmine data into other systems, or build tooling on top of Redmine. The ORM-style API means you work with resource objects and their attributes directly, rather than parsing JSON responses. Standard Edition is open-source under Apache 2.0; a Pro Edition with extended plugin support is available commercially.

Use it for:

- Automate issue creation and status updates in bulk from external data sources or CI/CD pipelines.
- Extract project and issue data for reporting, analytics, or integration with business intelligence tools.
- Build custom dashboards or monitoring tools that pull real-time data from Redmine.
- Synchronize Redmine issues with external ticketing or project management systems.
- Manage time entries and project resources programmatically for resource planning automation.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Python-Redmine provides a Django ORM-style Pythonic API for interacting with Redmine project management servers via their REST API, supporting resource creation, retrieval, filtering, and updates.

Yes, if you need to integrate with a Redmine server and want a stable, well-documented Python client. The library is production-ready (Development Status 5), has no known vulnerabilities, and low install friction. However, note that maintenance is dormant (last release 866 days ago)—suitable for established integrations but not ideal if you need active upstream support or compatibility with very recent Redmine versions. Verify your Redmine version compatibility before adopting.

## Install

pip install python-redmine
uv add python-redmine
poetry add python-redmine

## Installing python-redmine

Before you install: Low install friction with a single dependency (requests >= 2.31.0). Dormant maintenance status—last release was 866 days ago (2024-03-31), though the repository remains active with recent commits and no archived status. Suitable for stable, established Redmine integrations but not for projects requiring active upstream development.

License in practice: Apache 2.0 permissive license allows commercial and private use with minimal restrictions. Standard Edition is open-source; a Pro Edition with proprietary licensing is available separately for purchase.

Quickstart:

pip install python-redmine

from python_redmine import Redmine

redmine = Redmine('http://demo.redmine.org', username='foo', password='bar')
project = redmine.project.get('vacation')
print(project.issues[0].subject)

Requires Redmine server running with REST API enabled; requests >= 2.31.0 is mandatory as of version 2.5.0.

Verify before relying:

- Whether Pro Edition features (RedmineUP plugins) are available and what their licensing terms entail.
- Current state of Redmine server compatibility—changelog mentions Redmine >= 5.0.0 for some features but does not specify maximum supported version.
- Performance characteristics when working with large result sets or deeply nested resource relations.

## Package facts

- License: Apache 2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: dormant
- Downloads: 195.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

redmine api client python, redmine project management library, redmine rest api wrapper, redmine orm-style interface, redmine resource management, redmine issue tracking api, redmine python integration, redmine-integration, project-management-api, orm-style

[View on SkillFed](https://skillfed.io/packages/python-redmine) · [View on PyPI](https://pypi.org/project/python-redmine/)