English · 中文文档 · 中文

python-office

🚀 一行代码，搞定办公自动化
73 个开箱即用的 Skills，覆盖 PDF、Word、Excel、PPT、邮件、微信、图片、视频等全场景

⚡ TL;DR

python-office 是中文世界最受欢迎的 Python 办公自动化库。 一个库解决 90% 办公场景：PDF/Word/Excel/PPT 转换、图片处理、视频音频、微信机器人、邮件、文件管理、OCR、AI 工具…… 零基础也能上手——所有功能只需一行代码。

pip install python-office

import office  # 一行导入，所有功能立刻可用

✨ Key Features

📸 Demo

🚧 展示区 —— 你可以替换为你自己的截图或 GIF 动图

图片处理	PDF 处理	微信机器人
水印 / 词云 / 铅笔画	转 Word / 合并 / 加密	群发 / 智能聊天

Excel 处理	PPT 处理	视频/音频
模拟数据 / 合并 / 拆分	转 PDF / 转图	提取音频 / 字幕

🧭 快速跳转

🧩 Skills 体系（73 个开箱即用）

python-office 内置了一套 Skill 体系：把库里的 73 个方法封装成 73 个独立可调用的 Skill，每个 Skill 有自己的 SKILL.md 文档，可以单独 import，也可以整体使用。

💡 为什么是 Skill？ 借助 Skill，Codex、Claude、Cursor 等 AI 工具可以自动识别你的需求并调用对应功能。

# 方式 1：直接调用具体 Skill
from skills.image import compress_image
compress_image(input_file='photo.jpg', output_file='photo_small.jpg', quality=30)

# 方式 2：按分类批量导入
from skills.pdf import pdf2docx
pdf2docx(input_file='report.pdf', output_file='report.docx')

# 方式 3：原始的 office 方式（兼容）
import office
office.image.compress_image(input_file='photo.jpg', output_file='photo_small.jpg', quality=30)

📋 13 个分类速查表

👉 查看完整 Skill 索引：skills/README.md

📦 安装

# 一键安装（推荐）
pip install -i https://mirrors.aliyun.com/pypi/simple/ python-office -U

# 按需安装子库（更轻量）
pip install popdf      # 只用 PDF 处理
pip install poimage    # 只用图片处理
pip install poword     # 只用 Word 处理
pip install poexcel    # 只用 Excel 处理

Python 版本要求：Python 3.7+ 安装问题：📝 常见问题与故障排除

🚀 Quick Start（5 行代码体验）

# 1. PDF 转 Word
from skills.pdf import pdf2docx
pdf2docx(input_file='report.pdf', output_file='report.docx')

# 2. 批量压缩图片
from skills.image import compress_image
compress_image(input_file='big.jpg', output_file='small.jpg', quality=30)

# 3. 给图片加水印
from skills.image import add_watermark
add_watermark(file='photo.jpg', mark='@python-office')

# 4. 文本生成词云
from skills.image import txt2wordcloud
txt2wordcloud(filename='article.txt', result_file='wordcloud.png')

# 5. 生成二维码
from skills.tools import qrcodetools
qrcodetools(url='https://www.python-office.com', output='qrcode.png')

🎬 视频教程：https://www.python-office.com/video/video.html

💡 精选 Skill 一览

from skills.excel import fake2excel
fake2excel(columns=['name', 'phone'], rows=1000, path='test.xlsx')

from skills.excel import merge2excel
merge2excel(dir_path='./my_excels', output_file='all.xlsx')

from skills.pdf import pdf2docx       # PDF → Word
from skills.pdf import pdf2imgs        # PDF → 图片
from skills.pdf import merge2pdf       # 合并多个 PDF
from skills.pdf import split4pdf       # 拆分 PDF
from skills.pdf import encrypt4pdf     # 加密 PDF
from skills.pdf import add_watermark_by_parameters  # PDF 加水印

from skills.image import compress_image       # 压缩图片
from skills.image import add_watermark        # 加水印
from skills.image import del_watermark        # 去水印
from skills.image import txt2wordcloud        # 生成词云
from skills.image import pencil4img           # 转铅笔画
from skills.image import img2Cartoon          # 转卡通风格
from skills.image import decode_qrcode        # 解析二维码

from skills.wechat import send_message
send_message(who='文件传输助手', message='Hello!')

from skills.wechat import send_message_by_time
send_message_by_time(who='文件传输助手', message='早安', time='08:00:00')

from skills.video import video2mp3       # 视频 → MP3
from skills.video import audio2txt       # 音频 → 文字
from skills.video import txt2mp3         # 文字 → 语音
from skills.video import mark2video      # 视频加文字水印

🌟 适用场景

python-office 适用于以下人群和场景：

🛠️ 功能分类

每个功能既支持传统的 import office 方式，也支持从 skills.xxx 单独调用。

🗺️ 路线图

• v1.x：73 个 Skill，覆盖办公自动化全场景
• Skills 体系：每个功能可独立 AI 调用
• v2.0：插件化架构，支持自定义 Skill
• Web GUI：可视化操作界面
• 更多 AI 能力：AI 写作、AI 数据分析
• 企业版：私有部署 + 权限管理

欢迎在 Issues 中提需求！

📝 文档

• 📘 中文文档
• 📗 English Document
• 🎬 视频教程合集
• 🤖 Skills 索引
• ❓ 常见问题 FAQ

🤝 贡献代码

python-office 欢迎任何人来添砖加瓦。建议提交的 PR 放在一个独立的文件夹下：

• 在 contributors 文件夹中，用自己的 GitHub 名字建一个文件夹；
• 把自己的所有代码，都提交到这个自己的文件夹里；
• 不要修改其它任何文件夹下的代码；
• 对现有代码有疑问，可以直接提 issue。

代码风格

1. 注释：请为每个新函数的参数、返回值添加说明
2. 格式：只能格式化自己写的代码
3. 测试：单元测试可选，但强烈推荐
4. Skill：新增方法时，建议同时在 skills/<分类>/<方法名>/ 下加 Skill 封装

贡献者 ✨

感谢所有让 python-office 变得更好的朋友们！

🐞 提供 Bug 反馈或建议

提交问题反馈时，请务必填写和 python-office 代码本身有关的问题，不进行 Python 学习或个人练习的答疑。

• GitHub Issue
• Gitee Issue
• AtomGit Issue

💖 赞助 / Sponsor

如果 python-office 帮你节省了大量时间，欢迎支持我们持续维护：

• ⭐ Star 本项目 —— 这是最大的支持
• 🗣️ 向朋友推荐 —— 口碑传播
• 💰 微信赞赏 —— 二维码见文档底部
• 🐛 贡献代码 —— 提交 PR 或 Issue

📜 License

本项目使用 MIT License 开源。

MIT License

Copyright (c) 2026 CoderWanFeng

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

🙏 致谢

• 感谢所有贡献者、提 Issue 的用户
• 感谢 python4office 社区的支持
• 灵感来自 Requests、FastAPI、LangChain 等优秀开源项目
• Built with ❤️ in China

⭐ Star History

📌 联系作者

👉 加入开源交流群 · 联系作者微信 👈

_{如果这个项目对你有帮助，欢迎 ⭐ Star 支持一下！}