You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Looking for maintainers for python-docx-template #631
Hi all, I am the owner of python-docx-template project. I have received a lot of contributions from the community and I am truly grateful for that. However, today I no longer have enough time to maintain it. I am therefore looking for maintainers who can take over the management of this project. This would involve handling issues and pull requests and running the tests to ensure that python-docx-template works properly. I will continue to publish the code to PyPI. Ideally, I am looking for maintainers who have already submitted at least one pull request. If you are interested, please feel free to contact me.
Myself and my team would be interested in helping to maintain this project. We have been using python-docx and python-docx-template for a number of years and we have produced over 130,000 documents with these two packages, and have a long term plan to continue the use of both.
I submitted a PR for the python-docx-template project recently to improve the performance when working with very large documents. Please see #630
I have sent you a LinkedIn request to connect, feel free to message me there to discuss in more detail.
Looking forward to hearing from you.
Reacted by Robin Bennett, František Gič, James Sinton, Alexander Goryushkin, Felipe Raimann and Alessandro Ranellucci
I too connected with you on LinkedIn, and I have a fellow co-worker that is willing to put some time in as a maintainer a well. I'll be looking at PR's this weekend.
Hi @elapouya, I continued with another focused bug fix in #640 for #516, making the module CLI read JSON input as UTF-8 and adding regression coverage for Unicode data under an ASCII locale.
I am happy to keep working through reproducible bug reports and help with issue triage or PR review if maintainer help is still needed.
Hi Eric, I would like to help maintain the project if you are still looking.
I started by reproducing the core-properties corruption in #471 on current master and opened #657 with a regression test. I also independently tested and approved the runner fix in #652, found a Python 3.7/3.8 path problem while reviewing #655, and rechecked the stale packaging report in #611 against an exact current-master sdist.
I am happy to keep earning trust through issue reproduction, pull request review, and test verification. If there is a particular area of the backlog that needs consistent ownership, please point me at it and I can take responsibility for working through it.
Hi Eric — I'd like to help maintain the project too. My open PR is #655, fixing the Windows-locale UTF-8 crash from #516: two explicit-encoding fixes plus a regression script that reruns the suite under a forced non-UTF-8 locale. JackSpiece reviewed it, found a Python 3.8 path bug in the test harness, and I've pushed the fix with verification on CPython 3.8, 3.9 and 3.12. Beyond PRs, the open-issue backlog looks like it needs triage more than anything — I'd be glad to take a first pass at labelling reproducible bugs vs. usage questions if that helps you.
Hi Eric — I would like to help with a bounded maintenance area if help is still needed.
I have opened #662 with an exact issue fixture and Python 3.9/3.13/package verification. I also independently tested third-party PRs #642, #648, and #661 before submitting changes-request or approval reviews, and reproduced the narrow no-break-space behavior in issue #627 without turning it into an unsupported fix.
A useful starting responsibility for me would be reproducing incoming rendering/CLI/package reports and independently validating small pull requests with exact-head tests. I am happy to keep doing that through normal contributions before any permission change. If another backlog area is more useful, please point me to it.
OpenAI Codex assisted with the reproducibility and test work; I reviewed the public claims and remain responsible for the contribution.
Hi Eric, I'm interested in helping with maintenance. I opened #664 with a focused regression test and verified the fix against the reporter's attached DOCX.
I'd be happy to start by reproducing and triaging open issues, testing pending pull requests, and preparing small, reviewable fixes. I understand that trust and write access should follow demonstrated contributions, so please let me know which part of the backlog would be most useful to focus on next.
Correction to my note above: an independent backlog audit found that #656 already covers the same #559 fix more comprehensively. I closed my #664 as a duplicate immediately rather than leave redundant work for maintainers. I'll focus next on testing/reviewing existing PRs and on issues with no overlapping work.
Hi Eric — a brief follow-up to my September 1 note.
Since then I have opened two focused, independently tested fixes: #665 improves the actionable error when the optional subdocument dependency is missing, and #666 fixes inline-image reuse after an image-bearing subdocument merge. Both are deliberately narrow and ready for review.
I would be glad to keep contributing through reproducible bug reports, targeted regression coverage, and small PR validation, and to take on a bounded recurring maintenance area once that is useful. No permission change is expected before the work has earned trust.
First of all, thank you all for stepping up, submitting PRs, and trying to keep this project alive. It's great to see such strong community engagement and dedication.
However, it has been over 8 months since @elapouya's last response (Jan 17), and the repository appears to be completely stalled. Our efforts in triaging issues and submitting verified bug fixes (like #655, #657, #665, #666) are not getting the reviews or merges needed to actually help the wider user base.
Given the prolonged lack of activity from the current maintainer, I believe it is time to consider creating a community-driven fork (e.g., under a new GitHub organization). This would allow us to:
Merge the pending, verified bug fixes and improvements.
Actively triage and resolve open issues.
Publish updated, reliable versions to PyPI (potentially under a new package name, e.g., docxtpl-community or python-docx-template-ng, to avoid conflicts).
We already have the momentum, the domain knowledge, and the contributions. We just need a unified place to move forward without waiting for permissions that may never come.
If you are open to this, let's discuss the next steps (e.g., setting up a new org, consolidating PRs).
Reacted by Alessandro Ranellucci, Carl Gleisner and Srinivas Chippagiri
Picking up on @8thgencore's fork idea, I went ahead and started one: https://github.com/cvas22/docform, on PyPI as docform. 0.21.0 renders the same output as docxtpl 0.20.2 (I checked it against all the feature scripts), and it has the fixes from master since the last release, a pytest suite and CI. Next I want to bring over the verified PRs that are stuck here, with credit to their authors. Thx
Activity
JackByrne commentedon Jan 12, 2026
Hi @elapouya
Myself and my team would be interested in helping to maintain this project. We have been using
python-docxandpython-docx-templatefor a number of years and we have produced over 130,000 documents with these two packages, and have a long term plan to continue the use of both.I submitted a PR for the
python-docx-templateproject recently to improve the performance when working with very large documents. Please see #630I have sent you a LinkedIn request to connect, feel free to message me there to discuss in more detail.
Looking forward to hearing from you.
subtubes-io commentedon Jan 14, 2026
I can step in this weekend. We use the library at work pretty extensively so I will bring it up at standup in the AM. I'll be in touch.
subtubes-io commentedon Jan 14, 2026
I too connected with you on LinkedIn, and I have a fellow co-worker that is willing to put some time in as a maintainer a well. I'll be looking at PR's this weekend.
elapouya commentedon Jan 17, 2026
@subtubes-io I need a contribution from you before I can elect you as maintainer : a PR would be nice.
@JackByrne I just sent you an invitation
KushalLukhi commentedon Mar 24, 2026
Hi maintainers — I'm Kushal (@KushalLukhi). I'd like to volunteer as a maintainer/contributor for this project.
I can help with:
Happy to start with PR-based contributions and earn trust progressively. If you're open, please share the preferred onboarding path and first tasks.
bubaizhanshen commentedon Jun 1, 2026
Hi @elapouya, I opened #639 as a first contribution to address the invalid rendered XML/corrupted docx case from #634.
If maintainer help is still needed, I am happy to keep helping with issue triage, bug reproduction, and focused bug-fix PRs.
bubaizhanshen commentedon Jun 1, 2026
Hi @elapouya, I continued with another focused bug fix in #640 for #516, making the module CLI read JSON input as UTF-8 and adding regression coverage for Unicode data under an ASCII locale.
I am happy to keep working through reproducible bug reports and help with issue triage or PR review if maintainer help is still needed.
xdong99 commentedon Jun 27, 2026
Hi Eric,
I'm interested in helping with maintenance. I opened #652 as a small first PR to make the existing test runner more reliable.
I'm still getting familiar with the project, but I'd be happy to help triage issues and review small PRs first.
jackspiece commentedon Jul 30, 2026
Hi Eric, I would like to help maintain the project if you are still looking.
I started by reproducing the core-properties corruption in #471 on current
masterand opened #657 with a regression test. I also independently tested and approved the runner fix in #652, found a Python 3.7/3.8 path problem while reviewing #655, and rechecked the stale packaging report in #611 against an exact current-master sdist.I am happy to keep earning trust through issue reproduction, pull request review, and test verification. If there is a particular area of the backlog that needs consistent ownership, please point me at it and I can take responsibility for working through it.
davidpavlovschi commentedon Jul 30, 2026
Hi Eric — I'd like to help maintain the project too. My open PR is #655, fixing the Windows-locale UTF-8 crash from #516: two explicit-encoding fixes plus a regression script that reruns the suite under a forced non-UTF-8 locale. JackSpiece reviewed it, found a Python 3.8 path bug in the test harness, and I've pushed the fix with verification on CPython 3.8, 3.9 and 3.12. Beyond PRs, the open-issue backlog looks like it needs triage more than anything — I'd be glad to take a first pass at labelling reproducible bugs vs. usage questions if that helps you.
CAOShurong commentedon Aug 14, 2026
Hi Eric — I would like to help with a bounded maintenance area if help is still needed.
I have opened #662 with an exact issue fixture and Python 3.9/3.13/package verification. I also independently tested third-party PRs #642, #648, and #661 before submitting changes-request or approval reviews, and reproduced the narrow no-break-space behavior in issue #627 without turning it into an unsupported fix.
A useful starting responsibility for me would be reproducing incoming rendering/CLI/package reports and independently validating small pull requests with exact-head tests. I am happy to keep doing that through normal contributions before any permission change. If another backlog area is more useful, please point me to it.
OpenAI Codex assisted with the reproducibility and test work; I reviewed the public claims and remain responsible for the contribution.
ahmetmusab42-stack commentedon Sep 1, 2026
Hi Eric, I'm interested in helping with maintenance. I opened #664 with a focused regression test and verified the fix against the reporter's attached DOCX.
I'd be happy to start by reproducing and triaging open issues, testing pending pull requests, and preparing small, reviewable fixes. I understand that trust and write access should follow demonstrated contributions, so please let me know which part of the backlog would be most useful to focus on next.
ahmetmusab42-stack commentedon Sep 1, 2026
Correction to my note above: an independent backlog audit found that #656 already covers the same #559 fix more comprehensively. I closed my #664 as a duplicate immediately rather than leave redundant work for maintainers. I'll focus next on testing/reviewing existing PRs and on issues with no overlapping work.
ahmetmusab42-stack commentedon Sep 8, 2026
Hi Eric — a brief follow-up to my September 1 note.
Since then I have opened two focused, independently tested fixes: #665 improves the actionable error when the optional subdocument dependency is missing, and #666 fixes inline-image reuse after an image-bearing subdocument merge. Both are deliberately narrow and ready for review.
I would be glad to keep contributing through reproducible bug reports, targeted regression coverage, and small PR validation, and to take on a bounded recurring maintenance area once that is useful. No permission change is expected before the work has earned trust.
8thgencore commentedon Oct 14, 2026
Hi @JackByrne, @jackspiece, @davidpavlovschi, @CAOShurong, @ahmetmusab42-stack, and everyone else who has been actively contributing,
First of all, thank you all for stepping up, submitting PRs, and trying to keep this project alive. It's great to see such strong community engagement and dedication.
However, it has been over 8 months since @elapouya's last response (Jan 17), and the repository appears to be completely stalled. Our efforts in triaging issues and submitting verified bug fixes (like #655, #657, #665, #666) are not getting the reviews or merges needed to actually help the wider user base.
Given the prolonged lack of activity from the current maintainer, I believe it is time to consider creating a community-driven fork (e.g., under a new GitHub organization). This would allow us to:
docxtpl-communityorpython-docx-template-ng, to avoid conflicts).We already have the momentum, the domain knowledge, and the contributions. We just need a unified place to move forward without waiting for permissions that may never come.
If you are open to this, let's discuss the next steps (e.g., setting up a new org, consolidating PRs).
cvas22 commentedon Nov 15, 2026
Picking up on @8thgencore's fork idea, I went ahead and started one: https://github.com/cvas22/docform, on PyPI as
docform. 0.21.0 renders the same output as docxtpl 0.20.2 (I checked it against all the feature scripts), and it has the fixes from master since the last release, a pytest suite and CI. Next I want to bring over the verified PRs that are stuck here, with credit to their authors. Thxcvas22 commentedon Nov 15, 2026
cc @JackByrne @subtubes-io @KushalLukhi @bubaizhanshen @xdong99 @jackspiece @davidpavlovschi @CAOShurong @ahmetmusab42-stack since a lot of you have fixes waiting here. I'm happy to bring them over to docform with you as the author, or you can open them there directly.