resume-swallow 0.1.0__tar.gz

resume_swallow-0.1.0/PKG-INFO

@@ -0,0 +1,25 @@
+Metadata-Version: 2.4
+Name: resume-swallow
+Version: 0.1.0
+Summary: 批量简历格式化工具 - 将各种格式简历转化为结构化Excel
+Author-email: Chandler <275737875@qq.com>
+Requires-Python: >=3.10
+Requires-Dist: pdfplumber>=0.10.0
+Requires-Dist: PyMuPDF>=1.23.0
+Requires-Dist: python-docx>=1.0.0
+Requires-Dist: beautifulsoup4>=4.12.0
+Requires-Dist: chardet>=5.0.0
+Requires-Dist: openpyxl>=3.1.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: typer>=0.9.0
+Requires-Dist: fastapi>=0.100.0
+Requires-Dist: uvicorn>=0.23.0
+Provides-Extra: ocr
+Requires-Dist: pytesseract>=0.3.10; extra == "ocr"
+Requires-Dist: Pillow>=10.0.0; extra == "ocr"
+Provides-Extra: doc
+Requires-Dist: pywin32>=306; extra == "doc"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: httpx>=0.24.0; extra == "dev"

resume_swallow-0.1.0/README.md

@@ -0,0 +1,646 @@
+# Resume-Swallow
+
+**批量简历格式化工具** — 将各种格式的简历文件批量转化为结构化 Excel，专为招聘 HR 设计。
+
+[![Python 3.10+](https://img.shields.io/badge/Python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![Version](https://img.shields.io/badge/version-0.2.0-emerald.svg)](#)
+[![Tests](https://img.shields.io/badge/tests-109_passed-brightgreen.svg)](#)
+
+---
+
+## 目录
+
+- [简介](#简介)
+- [功能特性](#功能特性)
+- [核心流程](#核心流程)
+- [安装](#安装)
+- [快速开始](#快速开始)
+  - [方式一：Web 界面（推荐）](#方式一web-界面推荐)
+  - [方式二：GUI 图形界面](#方式二gui-图形界面)
+  - [方式三：CLI 命令行](#方式三cli-命令行)
+- [配置说明](#配置说明)
+- [CLI 命令详解](#cli-命令详解)
+- [输出格式](#输出格式)
+- [项目架构](#项目架构)
+- [开发指南](#开发指南)
+- [常见问题](#常见问题)
+- [变更记录](#变更记录)
+- [许可证](#许可证)
+
+---
+
+## 简介
+
+Resume-Swallow 是一个本地运行的批量简历处理工具，帮助招聘 HR 将杂乱的多格式简历文件（PDF、Word、TXT、HTML 等）统一提取为结构化信息，并汇总到一张 Excel 表格中。
+
+**目标用户：** 招聘 HR、猎头、招聘团队管理者 — 需要批量处理大量简历并整理为结构化数据的人员。
+
+**核心能力：** 多格式文件解析 → LLM 智能格式化 → 标准化 Excel 输出，一站式完成简历数据结构化。
+
+---
+
+## 功能特性
+
+- **多格式支持**：PDF / DOC / DOCX / TXT / MD / HTML
+- **LLM 智能提取**：使用大语言模型将非结构化简历文本提取为结构化 JSON
+- **批量处理**：一键处理整个文件夹，支持断点续传和强制覆盖
+- **三种使用方式**：
+  - **Web 界面** — 浏览器中操作，支持远程访问，适合团队协作
+  - **GUI 桌面界面** — Tkinter 图形界面，适合本地单机使用
+  - **CLI 命令行** — 适合自动化脚本和批量任务
+- **标准化 Excel 输出**：所有简历汇总到一张表格，可直接导入招聘系统
+- **OCR 支持**：可选启用 OCR 处理图片型 PDF（扫描件）
+- **兼容多种 LLM API**：支持 OpenAI、DeepSeek、通义千问等任何兼容 OpenAI API 格式的接口
+- **首次使用向导**：API Key 为空时自动引导配置
+- **本地运行**：数据不经过第三方服务器（仅 LLM API 调用）
+- **健康检查接口**：Web 服务提供 `/health` 端点，便于监控和运维
+
+---
+
+## 核心流程
+
+```
+简历文件 (PDF/DOC/DOCX/TXT/MD/HTML)
+        │
+        ▼
+   TXT 文本提取          ← file_parser.py
+        │
+        ▼
+   LLM 格式化 → JSON     ← llm_formatter.py
+        │
+        ▼
+   JSON → Excel          ← json_to_excel.py
+```
+
+三步流水线：**文件解析 → LLM 格式化 → Excel 导出**。每一步都可以单独执行，也可以通过 `process` 命令一键完成。
+
+---
+
+## 安装
+
+### 前置要求
+
+- Python 3.10 或更高版本
+- 一个可用的 LLM API（如 OpenAI API 或兼容接口）
+
+### 通过 pip 安装
+
+```bash
+pip install resume-swallow
+```
+
+### 从源码安装
+
+```bash
+git clone https://github.com/your-org/resume-swallow.git
+cd resume-swallow
+pip install -e .
+```
+
+### 可选依赖
+
+```bash
+# OCR 支持（处理图片型 PDF）
+pip install resume-swallow[ocr]
+
+# .doc 格式支持（Windows，需要 pywin32）
+pip install resume-swallow[doc]
+
+# 开发依赖（运行测试）
+pip install resume-swallow[dev]
+```
+
+---
+
+## 快速开始
+
+### 方式一：Web 界面（推荐）
+
+```bash
+resume-swallow web
+```
+
+默认在 `http://127.0.0.1:8000` 启动 Web 服务。打开浏览器访问该地址即可使用。
+
+**Web 界面功能：**
+
+1. **首次使用**：如果 API Key 为空，会自动弹出配置向导对话框
+2. **输入配置**：填写输入文件夹和输出文件夹路径
+3. **API 配置**：填写 API Key（支持显示/隐藏切换）、API URL、Model、Timeout、SSL验证
+4. **测试连接**：点击"测试连接"按钮验证 API 配置
+5. **处理选项**：启用 OCR、断点续传、强制覆盖、高级设置
+6. **高级设置**：工作/教育/项目经历条数、保存中间 TXT 文件
+7. **开始处理**：点击"开始处理"按钮，进度条和日志实时更新
+8. **停止处理**：处理过程中可点击"停止"按钮中断
+
+**自定义监听地址和端口：**
+
+```bash
+resume-swallow web --host 0.0.0.0 --port 9000
+```
+
+`--host 0.0.0.0` 允许局域网内其他设备访问，适合团队协作场景。
+
+### 方式二：GUI 图形界面
+
+```bash
+resume-swallow gui
+```
+
+打开桌面图形界面（Tkinter + ttk，Tailwind 风格主题），功能与 Web 界面完全一致。
+
+### 方式三：CLI 命令行
+
+#### 一键批量处理（最常用）
+
+```bash
+resume-swallow process ./resumes -k your-api-key
+```
+
+这会处理 `./resumes` 文件夹中的所有简历文件，自动完成"解析 → 格式化 → 导出 Excel"全流程。输出默认保存在 `./resumes_output/` 目录。
+
+#### 分步执行
+
+如果你只想执行某一步，可以使用单独的命令：
+
+```bash
+# 步骤1：仅格式化单个 TXT 文件为 JSON
+resume-swallow format ./resumes/zhangsan.txt -k your-api-key
+
+# 步骤2：仅将 JSON 文件夹导出为 Excel
+resume-swallow export ./resumes_output/json
+```
+
+---
+
+## 配置说明
+
+配置文件位于 `~/.resume-swallow/config.yaml`（Windows 为 `%USERPROFILE%\.resume-swallow\config.yaml`）。
+
+首次运行 `resume-swallow init` 会自动创建配置文件：
+
+```bash
+resume-swallow init
+```
+
+### 配置项详解
+
+```yaml
+llm:
+  api_key: ""                              # LLM API Key（必填）
+  api_url: "https://api.openai.com/v1"     # API 地址（支持兼容接口）
+  model: "gpt-4"                           # 模型名称
+  timeout: 60                              # 请求超时（秒）
+  verify_ssl: true                         # 是否验证 SSL 证书
+  temperature: 0.1                         # 生成温度（越低越稳定）
+
+output:
+  json_subdir: "json"                      # JSON 输出子目录名
+  excel_name: "resumes.xlsx"               # Excel 文件名
+  save_intermediate_txt: false             # 是否保存中间 TXT 文件
+
+processing:
+  max_retries: 1                           # 失败重试次数
+  force_overwrite: false                   # 是否强制覆盖已有输出
+  enable_ocr: false                        # 是否启用 OCR（图片型 PDF）
+  ocr_language: "chi_sim+eng"              # OCR 语言
+  max_work_experience: 3                   # 最多提取工作经历条数
+  max_education: 3                         # 最多提取教育经历条数
+  max_project_experience: 3                # 最多提取项目经历条数
+
+gui:
+  theme: "default"                         # GUI 主题
+  language: "zh_CN"                        # GUI 语言
+  show_advanced: false                     # 是否显示高级选项
+```
+
+### 使用兼容 API
+
+Resume-Swallow 支持任何兼容 OpenAI API 格式的接口。只需修改 `api_url` 和 `model`：
+
+```yaml
+llm:
+  api_key: "your-key"
+  api_url: "https://your-api-endpoint.com/v1"
+  model: "your-model-name"
+```
+
+命令行临时覆盖：
+
+```bash
+resume-swallow process ./resumes -k your-key -u https://your-api.com/v1 -m your-model
+```
+
+---
+
+## CLI 命令详解
+
+### `process` — 批量处理简历文件夹
+
+一键完成"解析 → 格式化 → 导出 Excel"全流程。
+
+```bash
+resume-swallow process <输入文件夹> [选项]
+```
+
+| 选项 | 简写 | 说明 |
+|------|------|------|
+| `--output` | `-o` | 输出文件夹路径（默认：输入文件夹同级 `_output` 目录） |
+| `--api-key` | `-k` | API Key（覆盖配置文件） |
+| `--api-url` | `-u` | API URL（覆盖配置文件） |
+| `--model` | `-m` | LLM 模型名称（覆盖配置文件） |
+| `--timeout` | `-t` | 请求超时秒数 |
+| `--resume` | `-r` | 断点续传（跳过已处理的文件） |
+| `--force` | `-f` | 强制覆盖已有输出文件 |
+| `--enable-ocr` | | 启用 OCR（处理图片型 PDF） |
+| `--max-retries` | | 最大重试次数 |
+| `--verbose` | | 详细日志输出 |
+
+**示例：**
+
+```bash
+# 基本用法
+resume-swallow process ./resumes -k sk-xxx
+
+# 断点续传 + 详细日志
+resume-swallow process ./resumes -k sk-xxx --resume --verbose
+
+# 自定义输出目录 + 强制覆盖
+resume-swallow process ./resumes -k sk-xxx -o ./output --force
+
+# 使用兼容 API
+resume-swallow process ./resumes -k sk-xxx -u https://api.deepseek.com/v1 -m deepseek-chat
+```
+
+### `format` — 仅 TXT → JSON 格式化
+
+将单个 TXT 文件通过 LLM 格式化为结构化 JSON。
+
+```bash
+resume-swallow format <输入TXT文件> [选项]
+```
+
+| 选项 | 简写 | 说明 |
+|------|------|------|
+| `--output` | `-o` | 输出 JSON 文件路径 |
+| `--api-key` | `-k` | API Key |
+| `--api-url` | `-u` | API URL |
+| `--model` | `-m` | LLM 模型名称 |
+| `--max-retries` | | 最大重试次数 |
+
+### `export` — 仅 JSON → Excel 转换
+
+将一个目录下的所有 JSON 文件合并导出为一张 Excel 表格。
+
+```bash
+resume-swallow export <JSON目录> [选项]
+```
+
+| 选项 | 简写 | 说明 |
+|------|------|------|
+| `--output` | `-o` | 输出 Excel 文件路径 |
+
+### `init` — 初始化配置文件
+
+```bash
+resume-swallow init
+```
+
+在 `~/.resume-swallow/config.yaml` 创建默认配置文件。
+
+### `gui` — 启动桌面图形界面
+
+```bash
+resume-swallow gui
+```
+
+启动 Tkinter 桌面 GUI（ttk + Tailwind 风格自定义主题）。
+
+### `web` — 启动 Web 界面
+
+```bash
+resume-swallow web [选项]
+```
+
+| 选项 | 简写 | 说明 |
+|------|------|------|
+| `--host` | `-h` | 监听地址（默认：127.0.0.1） |
+| `--port` | `-p` | 监听端口（默认：8000） |
+
+**示例：**
+
+```bash
+# 默认本地访问
+resume-swallow web
+
+# 允许局域网访问 + 自定义端口
+resume-swallow web --host 0.0.0.0 --port 9000
+```
+
+Web 界面使用 FastAPI 后端 + TailwindCSS/Alpine.js 前端，功能与 GUI 完全对齐。提供以下 REST API：
+
+| 端点 | 方法 | 说明 |
+|------|------|------|
+| `/` | GET | Web 页面 |
+| `/health` | GET | 健康检查 |
+| `/api/config` | GET | 获取当前配置 |
+| `/api/config` | POST | 更新配置 |
+| `/api/test-api` | POST | 测试 API 连接 |
+| `/api/process/start` | POST | 启动批量处理 |
+| `/api/process/stop` | POST | 停止处理 |
+| `/api/process/status` | GET | 获取处理状态和进度 |
+
+### `test-api` — 测试 API 连接
+
+```bash
+resume-swallow test-api -k your-api-key
+```
+
+验证 API Key 和 URL 是否可用，避免处理大批量文件后才发现配置错误。
+
+### `--version` — 查看版本
+
+```bash
+resume-swallow --version
+```
+
+---
+
+## 输出格式
+
+### JSON 结构
+
+每份简历格式化为以下 JSON 结构：
+
+```json
+{
+  "basic_info": {
+    "recruitment_category": "社招",
+    "name": "张三",
+    "gender": "男",
+    "location": "北京市",
+    "country_code": "+86",
+    "phone": "13800138000",
+    "wechat": "zhangsan_wx",
+    "email": "zhangsan@example.com",
+    "birth_year": "1990",
+    "resume_source": "脉脉",
+    "nationality": "",
+    "qq": "",
+    "other_phone": "",
+    "resume_code": ""
+  },
+  "work_experience": [
+    {
+      "company": "XX科技有限公司",
+      "position": "高级后端工程师",
+      "career_field": "互联网/技术",
+      "department": "",
+      "start_date": "2021-03",
+      "end_date": "至今",
+      "description": ""
+    }
+  ],
+  "education": [
+    {
+      "start_date": "2015-09",
+      "end_date": "2019-06",
+      "school": "北京大学",
+      "major": "计算机科学与技术",
+      "degree_level": "本科",
+      "degree": "",
+      "research_field": "",
+      "tag_3x": "",
+      "is_unified_recruitment": "是"
+    }
+  ],
+  "project_experience": [],
+  "personal_tags": ["高端"],
+  "job_intention": {
+    "intended_location": "北京市",
+    "expected_salary": "30-50K",
+    "staffing": "",
+    "work_type": ""
+  }
+}
+```
+
+### Excel 表格
+
+所有简历的 JSON 数据汇总到一张 Excel 表格，每个字段一列：
+
+- 基础信息：姓名、性别、所在地、电话、邮箱、微信等
+- 工作经历：最多 3 段（可配置），每段含公司、职位、时间、描述
+- 教育经历：最多 3 段（可配置），每段含学校、专业、学历、时间
+- 项目经历：最多 3 段（可配置），每段含项目名、职位、时间、职责
+- 个人标签：高端、稀缺、OD、五星/天才少年、应届生
+- 求职意向：期望地点、期望薪资
+
+---
+
+## 项目架构
+
+```
+resume-swallow/
+├── src/resume_swallow/
+│   ├── cli.py              # Typer CLI 入口（7个子命令）
+│   ├── main.py             # 模块入口点
+│   ├── __init__.py         # 版本号定义
+│   ├── core/               # 业务编排层
+│   │   ├── scheduler.py    # 批量调度器
+│   │   ├── pipeline.py     # 单文件流水线
+│   │   ├── error_handler.py# 错误处理
+│   │   └── progress.py     # 进度跟踪
+│   ├── engine/             # 处理引擎层
+│   │   ├── file_parser.py  # 多格式文件 → TXT
+│   │   ├── llm_formatter.py# TXT → JSON（LLM）
+│   │   └── json_to_excel.py# JSON → Excel
+│   ├── infra/              # 基础设施层
+│   │   ├── config.py       # 配置管理
+│   │   ├── logger.py       # 日志
+│   │   ├── api_client.py   # LLM API 客户端
+│   │   └── file_io.py      # 文件读写
+│   ├── gui/                # GUI 层
+│   │   ├── main_window.py  # 主窗口（ttk + 自定义 Style）
+│   │   └── theme.py        # Tailwind 风格主题
+│   ├── web/                # Web 层
+│   │   ├── app.py          # FastAPI 应用定义
+│   │   ├── routes.py       # REST API 端点
+│   │   ├── state.py        # 状态管理（线程安全）
+│   │   ├── exceptions.py   # 异常处理
+│   │   └── templates/
+│   │       └── index.html  # 前端页面（TailwindCSS + Alpine.js）
+│   └── prompts/
+│       └── format_prompt.md# 内置 LLM Prompt 模板
+├── config/
+│   └── default_config.yaml # 默认配置
+├── tests/                  # 单元测试（109个）
+│   ├── test_cli.py         # CLI 命令测试
+│   ├── test_file_parser.py # 文件解析测试
+│   ├── test_infra.py       # 基础设施测试
+│   ├── test_json_to_excel.py# Excel 导出测试
+│   ├── test_llm_formatter.py# LLM 格式化测试
+│   ├── test_pipeline.py    # 流水线测试
+│   └── test_web.py         # Web API 测试
+├── docs/                   # 设计文档
+├── pyproject.toml          # 打包配置
+├── requirements.txt        # 依赖列表
+└── CHANGELOG.md            # 变更记录
+```
+
+四层架构：**GUI/Web → Core → Engine → Infra**，每层只依赖下层，职责清晰。
+
+- **GUI/Web 层**：用户交互（桌面 GUI 和 Web 界面）
+- **Core 层**：业务编排（批量调度、流水线、进度、错误处理）
+- **Engine 层**：处理引擎（文件解析、LLM 格式化、Excel 导出）
+- **Infra 层**：基础设施（配置、日志、API 客户端、文件 IO）
+
+---
+
+## 开发指南
+
+### 环境搭建
+
+```bash
+git clone https://github.com/your-org/resume-swallow.git
+cd resume-swallow
+pip install -e ".[dev]"
+```
+
+### 运行测试
+
+```bash
+pytest
+```
+
+109 个测试覆盖 CLI 命令、文件解析、LLM 格式化、JSON 导出、流水线、基础设施、Web API 等模块。
+
+### 代码结构约定
+
+- **新增 CLI 命令**：在 `cli.py` 中添加 `@app.command()` 函数
+- **新增文件格式支持**：在 `engine/file_parser.py` 中扩展 `SUPPORTED_FORMATS`
+- **修改 LLM Prompt**：编辑 `src/resume_swallow/prompts/format_prompt.md`
+- **修改输出字段**：同步修改 Prompt 模板和 `engine/json_to_excel.py`
+- **新增 Web API 端点**：在 `web/routes.py` 中添加路由函数
+- **修改前端页面**：编辑 `web/templates/index.html`（TailwindCSS + Alpine.js）
+
+### 提交规范
+
+- 提交前确保所有测试通过：`pytest`
+- 提交信息格式：`<type>: <description>`（如 `feat: 新增 web 子命令`、`fix: 修复 GUI 方法名错误`）
+- 类型：`feat`（新功能）、`fix`（修复）、`refactor`（重构）、`test`（测试）、`docs`（文档）
+
+### 技术栈
+
+| 层 | 技术 |
+|------|------|
+| CLI | Typer |
+| GUI | Tkinter + ttk（自定义 Tailwind 风格 Style） |
+| Web 后端 | FastAPI + uvicorn |
+| Web 前端 | TailwindCSS + Alpine.js |
+| 文件解析 | pdfplumber、PyMuPDF、python-docx、beautifulsoup4 |
+| Excel | openpyxl |
+| LLM | requests（兼容 OpenAI API 格式） |
+| 配置 | YAML（pyyaml） |
+| 测试 | pytest + httpx（Web API 测试） |
+
+---
+
+## 常见问题
+
+### Q: 处理 PDF 时报错"无法提取文本"
+
+部分 PDF 是扫描图片而非文本型 PDF。使用 `--enable-ocr` 选项启用 OCR 支持（需安装 `resume-swallow[ocr]`）：
+
+```bash
+resume-swallow process ./resumes -k sk-xxx --enable-ocr
+```
+
+### Q: LLM API 调用失败
+
+先用 `test-api` 命令验证连接：
+
+```bash
+resume-swallow test-api -k sk-xxx -u https://api.openai.com/v1
+```
+
+常见原因：API Key 错误、API URL 不正确、网络超时（尝试增加 `--timeout`）。
+
+### Q: 处理大量文件时中途失败
+
+使用 `--resume` 选项断点续传，已成功处理的文件会被跳过：
+
+```bash
+resume-swallow process ./resumes -k sk-xxx --resume
+```
+
+### Q: 如何使用国产 LLM API
+
+修改 `api_url` 和 `model` 即可，只要接口兼容 OpenAI API 格式：
+
+```bash
+# DeepSeek
+resume-swallow process ./resumes -k sk-xxx -u https://api.deepseek.com/v1 -m deepseek-chat
+
+# 通义千问
+resume-swallow process ./resumes -k sk-xxx -u https://dashscope.aliyuncs.com/compatible-mode/v1 -m qwen-plus
+```
+
+### Q: .doc 格式文件无法解析
+
+`.doc`（旧版 Word 格式）需要 Windows 环境和 pywin32。安装：
+
+```bash
+pip install resume-swallow[doc]
+```
+
+### Q: Web 服务无法远程访问
+
+默认监听 `127.0.0.1`（仅本地）。使用 `--host 0.0.0.0` 允许局域网访问：
+
+```bash
+resume-swallow web --host 0.0.0.0
+```
+
+注意：确保防火墙允许对应端口访问。
+
+### Q: Web 服务的健康检查端点是什么
+
+```bash
+curl http://127.0.0.1:8000/health
+# 返回: {"status": "ok", "version": "0.2.0"}
+```
+
+可用于容器编排、负载均衡等场景的健康探测。
+
+---
+
+## 变更记录
+
+详见 [CHANGELOG.md](CHANGELOG.md)。
+
+---
+
+## 许可证
+
+MIT License
+
+Copyright (c) 2026 Resume-Swallow Contributors
+
+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.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

resume_swallow-0.1.0/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "resume-swallow"
+version = "0.1.0"
+description = "批量简历格式化工具 - 将各种格式简历转化为结构化Excel"
+authors = [
+    {name = "Chandler", email = "275737875@qq.com"},
+]
+requires-python = ">=3.10"
+dependencies = [
+    "pdfplumber>=0.10.0",
+    "PyMuPDF>=1.23.0",
+    "python-docx>=1.0.0",
+    "beautifulsoup4>=4.12.0",
+    "chardet>=5.0.0",
+    "openpyxl>=3.1.0",
+    "requests>=2.31.0",
+    "pyyaml>=6.0",
+    "typer>=0.9.0",
+    "fastapi>=0.100.0",
+    "uvicorn>=0.23.0",
+]
+
+[project.optional-dependencies]
+ocr = ["pytesseract>=0.3.10", "Pillow>=10.0.0"]
+doc = ["pywin32>=306"]
+dev = ["pytest>=7.0.0", "httpx>=0.24.0"]
+
+[project.scripts]
+resume-swallow = "resume_swallow.cli:app"
+
+[tool.setuptools.package-data]
+resume_swallow = ["prompts/*.md", "web/templates/*.html"]
+
+[tool.setuptools.packages.find]
+where = ["src"]