python-office

🚀 一行代码，搞定办公自动化
81 个开箱即用的 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

	功能
🎯 一行代码	90% 的功能只需 `office.模块.方法()`，零学习成本
🧩 81 个 Skills	每个功能独立可调，按需使用，不冗余
🤖 AI 友好	每个 Skill 都有 `SKILL.md` + YAML 描述，Codex/Claude/Cursor 可直接识别
🌏 中文优先	全中文文档、视频教程、微信答疑群
🪶 轻量灵活	不需要的功能可以不安装：`pip install popdf` / `poimage` / `poword`
🔄 持续更新	持续维护中，81+ 功能仍在迭代
📦 一次安装	`import office` 即引入全部能力；不想要也可单独 import
🛡️ 稳定可靠	已被数千个项目使用，Apache-2.0 开源

📸 Demo

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

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

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

🧭 快速跳转

想做什么？	跳到
第一次使用	📦 安装
看 5 个例子感受一下	🚀 Quick Start
找具体功能	🛠️ 功能分类或 `skills/README.md`
了解 Skill 体系	✨ Skills 体系
加群提问	💬 联系作者
给项目贡献代码	🤝 贡献

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

python-office 内置了一套 Skill 体系：把库里的 81 个方法封装成 81 个独立可调用的 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)

📋 14 个分类速查表

分类	Skill 数	典型 Skill
📊 Excel	12	`fake2excel` / `merge2excel` / `excel2pdf`
📁 File	10	`replace4filename` / `get_files`
💰 Finance	1	`t0`（股票做 T 收益计算）
🖼️ Image	9	`compress_image` / `add_watermark` / `txt2wordcloud`
📝 Markdown	1	`excel2markdown`
🔍 OCR	1	`VatInvoiceOCR2Excel`（增值税发票识别）
📕 PDF	13	`pdf2docx` / `pdf2imgs` / `merge2pdf` / `encrypt4pdf`
🎬 PPT	3	`ppt2pdf` / `ppt2img` / `merge4ppt`
🛠️ Tools	10	`transtools` / `qrcodetools` / `passwordtools`
🌐 Web	1	`url2ebook`
🎥 Video	5	`video2mp3` / `audio2txt` / `txt2mp3` / `video_edit`
💬 WeChat	7	`send_message` / `chat_robot` / `receive_message`
📄 Word	5	`docx2pdf` / `merge4docx` / `docx4imgs`
🏷️ Ruiming	3	`screen_unmarked_image` / `change_label_in_xml`

👉 查看完整 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+ 安装问题：📝 常见问题与故障排除

💻 命令行：`po` 命令

安装 python-office 后自带终端命令，不写代码也能用：

po pdf merge2pdf a.pdf b.pdf --output-file merged.pdf
po excel excel2pdf 报表.xlsx 报表.pdf
po tools url2ip www.python-office.com

po --json tools url2ip www.python-office.com   # 单行 JSON 输出，方便脚本和 agent 调用

po --help 查看全部模块与子命令（python -m office 为等价入口）。

🚀 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 一览

📊 Excel 处理（点击展开）

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')

📕 PDF 处理（点击展开）

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 加水印

🖼️ Image 图像处理（点击展开）

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')

🎬 Video 视频处理（点击展开）

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

🌟 适用场景

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

👤 人群	🎯 场景
📊 职场白领	批量处理 PDF、Excel、Word、PPT，提高 10x 效率
🎓 学生 / 教师	论文排版、试卷批改、资料整理
👨‍💻 开发者	自动化脚本、爬虫数据处理、文件批处理
🤖 AI 玩家	让 AI 自动调用工具完成复杂办公任务
📷 运营 / 自媒体	图片批量处理、视频转音频、生成二维码
💼 财务 / HR	发票 OCR、Excel 合并、文件整理

🛠️ 功能分类

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

模块	功能	Skills 路径
PyOfficeRobot	微信机器人	`skills/wechat/`
poocr	文字识别（发票、表格、图片）	`skills/ocr/`
popdf	PDF 转 Word / 图片 / 拆分 / 合并 / 加密	`skills/pdf/`
poemail	自动发邮件	`office/api/email.py`
porobot	AI 机器人	`office/api/tools.py`
poimage	图片压缩 / 水印 / 词云 / 滤镜	`skills/image/`
poai	AI 工具集	`office/lib/`
poexcel	Excel 合并 / 拆分 / 模拟数据	`skills/excel/`
poword	Word 转 PDF / 提取图片	`skills/word/`
pofile	文件批量重命名 / 整理	`skills/file/`
search4file	文档搜索	`skills/file/`
poppt	PPT 转 PDF / 图片	`skills/ppt/`
wftools	翻译 / 二维码 / 密码生成等小工具	`skills/tools/`
pofinance	股票做 T 计算	`skills/finance/`
pohan	中文编程	-
povideo	视频转音频 / 语音识别	`skills/video/`
potime	时间工具	-
poprogress	进度条工具	-
pocode	代码管理	-

🗺️ 路线图

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

欢迎在 Issues 中提需求！

📝 文档

🤝 贡献代码

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

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

代码风格

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

贡献者 ✨

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

🐞 提供 Bug 反馈或建议

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

💖 赞助 / Sponsor

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

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

📜 License

本项目使用 Apache License 2.0 开源。

完整协议文本见仓库根目录的 LICENSE 文件。

🙏 致谢

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

⭐ Star History

📌 联系作者

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

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

Navigation Menu

Repository navigation

README-CN.md

README-CN.md

python-office

⚡ TL;DR

✨ Key Features

📸 Demo

🧭 快速跳转

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

📋 14 个分类速查表

📦 安装

💻 命令行：`po` 命令

🚀 Quick Start（5 行代码体验）

💡 精选 Skill 一览

🌟 适用场景

🛠️ 功能分类

🗺️ 路线图

📝 文档

🤝 贡献代码

代码风格

贡献者 ✨

🐞 提供 Bug 反馈或建议

💖 赞助 / Sponsor

📜 License

🙏 致谢

⭐ Star History

📌 联系作者

FilesExpand file tree

README-CN.md

Latest commit

History

README-CN.md

File metadata and controls

python-office

⚡ TL;DR

✨ Key Features

📸 Demo

🧭 快速跳转

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

📋 14 个分类速查表

📦 安装

💻 命令行：po 命令

🚀 Quick Start（5 行代码体验）

💡 精选 Skill 一览

🌟 适用场景

🛠️ 功能分类

🗺️ 路线图

📝 文档

🤝 贡献代码

代码风格

贡献者 ✨

🐞 提供 Bug 反馈或建议

💖 赞助 / Sponsor

📜 License

🙏 致谢

⭐ Star History

📌 联系作者

💻 命令行：`po` 命令