feat: Add LandPPT uv configuration and setup scripts

- Updated uv.toml for LandPPT with cache directory and python preference. - Created comprehensive uv usage guide in Chinese. - Added Windows setup script (setup.bat) for easy installation and environment setup. - Implemented Python setup script (setup.py) for cross-platform environment configuration. - Developed Unix/Linux/macOS setup script (setup.sh) for streamlined project initialization.
2026-08-28 23:31:06 +08:00 · 2025-07-01 16:34:21 +08:00
parent 53c28a5c67
commit 16882869c1
15 changed files with 1158 additions and 807 deletions
@@ -1,8 +1,8 @@
 # LandPPT - AI驱动的PPT生成平台

-[![GitHub stars](https://img.shields.io/github/stars/your-username/LandPPT?style=flat-square)](https://github.com/your-username/LandPPT/stargazers)
-[![GitHub forks](https://img.shields.io/github/forks/your-username/LandPPT?style=flat-square)](https://github.com/your-username/LandPPT/network)
-[![GitHub issues](https://img.shields.io/github/issues/your-username/LandPPT?style=flat-square)](https://github.com/your-username/LandPPT/issues)
+[![GitHub stars](https://img.shields.io/github/stars/sligter/LandPPT?style=flat-square)](https://github.com/sligter/LandPPT/stargazers)
+[![GitHub forks](https://img.shields.io/github/forks/sligter/LandPPT?style=flat-square)](https://github.com/sligter/LandPPT/network)
+[![GitHub issues](https://img.shields.io/github/issues/sligter/LandPPT?style=flat-square)](https://github.com/sligter/LandPPT/issues)
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg?style=flat-square)](LICENSE)
 [![Python](https://img.shields.io/badge/python-3.11+-blue.svg?style=flat-square)](https://www.python.org)
 [![FastAPI](https://img.shields.io/badge/FastAPI-0.104+-green.svg?style=flat-square)](https://fastapi.tiangolo.com)
@@ -15,6 +15,7 @@
 ## 📋 目录

 - [项目简介](#-项目简介)
+- [系统架构](#️-系统架构)
 - [核心功能](#-核心功能)
 - [快速开始](#-快速开始)
 - [使用指南](#-使用指南)
@@ -26,46 +27,47 @@

 ## 🎯 项目简介

-LandPPT 是一个基于人工智能的演示文稿生成平台，能够自动将文档内容转换为专业的PPT演示文稿。平台支持多种AI模型，提供丰富的模板和样式选择，让用户能够快速创建高质量的演示文稿。
+LandPPT 是一个基于人工智能的演示文稿生成平台，能够自动将文档内容转换为专业的PPT演示文稿。平台支持多种AI模型，提供丰富的模板和样式选择，让用户能够创建高质量的演示文稿。
+
+
+![image](https://img.pub/p/17ebc2a837fc02827d4a.png)
+
+![image](https://img.pub/p/3a7dff4a4b9aebedc260.png)
+
+![image](https://img.pub/p/56e2a5801875736f9fc5.png)
+
+## 🏗️ 系统架构
+
+![image](https://img.pub/p/906dd30aac5cbb27a4e5.svg)

 ## ✨ 核心功能

 ### 🤖 多AI提供商支持
- **OpenAI GPT系列**：GPT-3.5/GPT-4 等主流模型
+- **OpenAI GPT系列**：GPT-4.5/GPT-5 等主流模型
 - **Anthropic Claude**：Claude-3 系列模型
- **Google Gemini**：Gemini-1.5 系列模型
+- **Google Gemini**：Gemini-2.5 系列模型
 - **Azure OpenAI**：企业级AI服务
 - **Ollama**：本地部署的开源模型

 ### 📄 强大的文件处理能力
 - **多格式支持**：PDF、Word、Markdown、TXT等
- **智能解析**：使用magic-pdf和markitdown进行内容提取
- **本地缓存**：MD5哈希校验的文件缓存系统
+- **智能解析**：使用minueru和markitdown进行内容提取
 - **深度研究**：集成Tavily API的DEEP研究功能

 ### 🎨 丰富的模板系统
 - **全局主模板**：统一的HTML模板系统
 - **多样化布局**：AI生成多种创意页面布局
- **场景化设计**：商务、教育、技术等专业模板
 - **自定义模板**：支持导入和创建个性化模板

 ### 📊 完整的项目管理
 - **三阶段工作流**：需求确认 → 大纲生成 → PPT生成
- **可视化编辑**：思维导图式的大纲编辑器
- **版本控制**：项目版本管理和历史记录
+- **可视化编辑**：大纲编辑器
 - **实时预览**：16:9响应式页面预览

-### 🔧 开发者友好
- **RESTful API**：完整的API接口
- **OpenAI兼容**：兼容OpenAI API格式
- **实时配置**：无需重启的配置更新
- **健康检查**：完善的服务监控
-
 ### 🌐 现代化Web界面
 - **直观操作**：用户友好的Web界面
 - **AI聊天编辑**：侧边栏AI编辑功能
 - **多格式导出**：PDF/HTML/PPTX导出支持
- **响应式设计**：适配各种设备

 ## 🚀 快速开始

@@ -76,34 +78,54 @@ LandPPT 是一个基于人工智能的演示文稿生成平台，能够自动将

 ### 本地安装

+#### 方法一：一键设置脚本（最简单）
+
 ```bash
 # 克隆项目
-git clone https://github.com/your-username/LandPPT.git
+git clone https://github.com/sligter/LandPPT.git
 cd LandPPT

-# 使用uv安装依赖（推荐）
-pip install uv
-uv pip install -e .
+# Windows用户
+scripts\setup.bat

-# 或使用pip安装
-pip install -e .
+# Linux/macOS用户
+bash scripts/setup.sh
+
+# 或使用Python脚本
+python scripts/setup.py
+```
+
+#### 方法二：使用uv手动设置（推荐）
+
+```bash
+# 克隆项目
+git clone https://github.com/sligter/LandPPT.git
+cd LandPPT
+
+# 安装uv（如果尚未安装）
+# Windows (PowerShell)
+powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+# macOS/Linux
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# 使用uv同步环境
+uv sync

 # 配置环境变量
 cp .env.example .env
 # 编辑 .env 文件，配置你的AI API密钥

-# 初始化数据库
-python setup_database.py
-
 # 启动服务
-python run.py
+uv run python run.py
 ```

 ### Docker部署

+#### 使用预构建镜像（推荐）
+
 ```bash
-# 构建镜像
-docker build -t landppt .
+# 拉取最新镜像
+docker pull bradleylzh/landppt:latest

 # 运行容器
 docker run -d \
@@ -111,56 +133,16 @@ docker run -d \
  -p 8000:8000 \
  -v $(pwd)/.env:/app/.env \
  -v landppt_data:/app/data \
-  -v landppt_uploads:/app/uploads \
-  landppt
+  -v landppt_reports:/app/research_reports \
+  -v landppt_cache:/app/temp \
+  bradleylzh/landppt:latest

 # 查看日志
 docker logs -f landppt
 ```

-### 使用Docker Compose（推荐）
+> **注意**: 确保在运行前创建并配置好 `.env` 文件，包含必要的API密钥。

-创建 `docker-compose.yml` 文件：
-
-```yaml
-version: '3.8'
-
-services:
-  landppt:
-    build: .
-    ports:
-      - "8000:8000"
-    volumes:
-      - ./.env:/app/.env
-      - landppt_data:/app/data
-      - landppt_uploads:/app/uploads
-      - landppt_reports:/app/research_reports
-    environment:
-      - PYTHONPATH=/app/src
-    restart: unless-stopped
-    healthcheck:
-      test: ["CMD", "./docker-healthcheck.sh"]
-      interval: 30s
-      timeout: 30s
-      retries: 3
-      start_period: 40s
-
-volumes:
-  landppt_data:
-  landppt_uploads:
-  landppt_reports:
-```
-
-```bash
-# 启动服务
-docker-compose up -d
-
-# 查看状态
-docker-compose ps
-
-# 查看日志
-docker-compose logs -f
-```

 ## 📖 使用指南

@@ -179,11 +161,11 @@ docker-compose logs -f

 ### 3. 创建PPT项目
 1. **需求确认**：输入主题、选择受众、设置页数范围
-2. **大纲生成**：AI生成可编辑的思维导图大纲
+2. **大纲生成**：AI生成大纲
 3. **PPT生成**：基于大纲生成完整的HTML演示文稿

 ### 4. 编辑和导出
- 使用AI聊天功能编辑内容
+- 使用AI聊天功能编辑HTML内容
 - 导出为PDF、HTML或PPTX格式
 - 保存项目版本和历史记录

@@ -206,7 +188,7 @@ PORT=8000
 SECRET_KEY=your-secure-secret-key

 # 功能配置
-TAVILY_API_KEY=your_tavily_api_key_here  # 研究功能
+TAVILY_API_KEY=your_tavily_api_key_here  # 联网功能
 APRYSE_LICENSE_KEY=your_apryse_key_here  # PPTX导出

 # 生成参数
@@ -220,26 +202,6 @@ TEMPERATURE=0.7
 - **Swagger UI**: `http://localhost:8000/docs`
 - **ReDoc**: `http://localhost:8000/redoc`

-### 主要API端点
-
-```bash
-# 健康检查
-GET /health
-
-# 项目管理
-POST /api/projects          # 创建项目
-GET /api/projects           # 获取项目列表
-GET /api/projects/{id}      # 获取项目详情
-
-# 文件处理
-POST /api/upload            # 上传文件
-POST /api/files/upload-and-generate-outline  # 上传并生成大纲
-
-# OpenAI兼容接口
-POST /v1/chat/completions   # 聊天完成
-POST /v1/completions        # 文本完成
-```
-
 ## 🛠️ 技术栈

 ### 后端技术
@@ -255,15 +217,12 @@ POST /v1/completions        # 文本完成
 - **LangChain**: AI应用开发框架

 ### 文件处理
- **magic-pdf**: PDF智能解析
+- **mineru**: PDF智能解析
 - **markitdown**: 多格式文档转换
- **python-docx**: Word文档处理
- **BeautifulSoup**: HTML解析

 ### 导出功能
 - **Pyppeteer**: HTML转PDF
 - **Apryse SDK**: PPTX生成
- **Jinja2**: 模板渲染

 ## 🤝 贡献指南

@@ -276,22 +235,7 @@ POST /v1/completions        # 文本完成
 4. 推送到分支 (`git push origin feature/AmazingFeature`)
 5. 开启 Pull Request

-### 开发环境设置
-```bash
-# 克隆你的fork
-git clone https://github.com/your-username/LandPPT.git
-cd LandPPT
-
-# 安装开发依赖
-uv pip install -e ".[dev]"
-
-# 运行测试
-pytest
-
-# 代码格式化
-black src/
-isort src/
-```
+详情请见 [贡献指南](CONTRIBUTING.md)。

 ### 报告问题
 如果你发现了bug或有功能建议，请在 [Issues](https://github.com/sligter/LandPPT/issues) 页面创建新的issue。
@@ -1,8 +1,8 @@
 # LandPPT - AI-Powered PPT Generation Platform

-[![GitHub stars](https://img.shields.io/github/stars/your-username/LandPPT?style=flat-square)](https://github.com/your-username/LandPPT/stargazers)
-[![GitHub forks](https://img.shields.io/github/forks/your-username/LandPPT?style=flat-square)](https://github.com/your-username/LandPPT/network)
-[![GitHub issues](https://img.shields.io/github/issues/your-username/LandPPT?style=flat-square)](https://github.com/your-username/LandPPT/issues)
+[![GitHub stars](https://img.shields.io/github/stars/sligter/LandPPT?style=flat-square)](https://github.com/sligter/LandPPT/stargazers)
+[![GitHub forks](https://img.shields.io/github/forks/sligter/LandPPT?style=flat-square)](https://github.com/sligter/LandPPT/network)
+[![GitHub issues](https://img.shields.io/github/issues/sligter/LandPPT?style=flat-square)](https://github.com/sligter/LandPPT/issues)
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg?style=flat-square)](LICENSE)
 [![Python](https://img.shields.io/badge/python-3.11+-blue.svg?style=flat-square)](https://www.python.org)
 [![FastAPI](https://img.shields.io/badge/FastAPI-0.104+-green.svg?style=flat-square)](https://fastapi.tiangolo.com)
@@ -15,6 +15,7 @@
 ## 📋 Table of Contents

 - [Project Overview](#-project-overview)
+- [System Architecture](#️-system-architecture)
 - [Key Features](#-key-features)
 - [Quick Start](#-quick-start)
 - [Usage Guide](#-usage-guide)
@@ -26,46 +27,47 @@

 ## 🎯 Project Overview

-LandPPT is an AI-powered presentation generation platform that automatically converts document content into professional PPT presentations. The platform supports multiple AI models and provides rich templates and style options, enabling users to quickly create high-quality presentations.
+LandPPT is an AI-powered presentation generation platform that automatically converts document content into professional PPT presentations. The platform supports multiple AI models and provides rich templates and style options, enabling users to create high-quality presentations.
+
+
+![image](https://img.pub/p/17ebc2a837fc02827d4a.png)
+
+![image](https://img.pub/p/3a7dff4a4b9aebedc260.png)
+
+![image](https://img.pub/p/56e2a5801875736f9fc5.png)
+
+## 🏗️ System Architecture
+
+![image](https://img.pub/p/906dd30aac5cbb27a4e5.svg)

 ## ✨ Key Features

 ### 🤖 Multi-AI Provider Support
- **OpenAI GPT Series**: GPT-3.5/GPT-4 and other mainstream models
+- **OpenAI GPT Series**: GPT-4.5/GPT-5 and other mainstream models
 - **Anthropic Claude**: Claude-3 series models
- **Google Gemini**: Gemini-1.5 series models
+- **Google Gemini**: Gemini-2.5 series models
 - **Azure OpenAI**: Enterprise-grade AI services
 - **Ollama**: Locally deployed open-source models

 ### 📄 Powerful File Processing
 - **Multi-format Support**: PDF, Word, Markdown, TXT, etc.
- **Intelligent Parsing**: Content extraction using magic-pdf and markitdown
- **Local Caching**: File caching system with MD5 hash verification
+- **Intelligent Parsing**: Content extraction using minueru and markitdown
 - **Deep Research**: DEEP research functionality with Tavily API integration

 ### 🎨 Rich Template System
 - **Global Master Templates**: Unified HTML template system
 - **Diverse Layouts**: AI-generated creative page layouts
- **Scenario-based Design**: Professional templates for business, education, tech, etc.
 - **Custom Templates**: Support for importing and creating personalized templates

 ### 📊 Complete Project Management
 - **Three-stage Workflow**: Requirements confirmation → Outline generation → PPT generation
- **Visual Editing**: Mind map-style outline editor
- **Version Control**: Project version management and history tracking
+- **Visual Editing**: Outline editor
 - **Real-time Preview**: 16:9 responsive page preview

-### 🔧 Developer Friendly
- **RESTful API**: Complete API interface
- **OpenAI Compatible**: Compatible with OpenAI API format
- **Real-time Configuration**: Configuration updates without restart
- **Health Monitoring**: Comprehensive service monitoring
-
 ### 🌐 Modern Web Interface
 - **Intuitive Operation**: User-friendly web interface
 - **AI Chat Editing**: Sidebar AI editing functionality
 - **Multi-format Export**: PDF/HTML/PPTX export support
- **Responsive Design**: Adaptive to various devices

 ## 🚀 Quick Start

@@ -76,34 +78,54 @@ LandPPT is an AI-powered presentation generation platform that automatically con

 ### Local Installation

+#### Method 1: One-Click Setup Script (Easiest)
+
 ```bash
 # Clone the repository
-git clone https://github.com/your-username/LandPPT.git
+git clone https://github.com/sligter/LandPPT.git
 cd LandPPT

-# Install dependencies using uv (recommended)
-pip install uv
-uv pip install -e .
+# Windows users
+scripts\setup.bat

-# Or use pip
-pip install -e .
+# Linux/macOS users
+bash scripts/setup.sh
+
+# Or use Python script
+python scripts/setup.py
+```
+
+#### Method 2: Manual Setup with uv (Recommended)
+
+```bash
+# Clone the repository
+git clone https://github.com/sligter/LandPPT.git
+cd LandPPT
+
+# Install uv (if not already installed)
+# Windows (PowerShell)
+powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+# macOS/Linux
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Sync environment with uv
+uv sync

 # Configure environment variables
 cp .env.example .env
 # Edit .env file and configure your AI API keys

-# Initialize database
-python setup_database.py
-
 # Start the service
-python run.py
+uv run python run.py
 ```

 ### Docker Deployment

+#### Using Pre-built Image (Recommended)
+
 ```bash
-# Build image
-docker build -t landppt .
+# Pull the latest image
+docker pull bradleylzh/landppt:latest

 # Run container
 docker run -d \
@@ -111,56 +133,17 @@ docker run -d \
  -p 8000:8000 \
  -v $(pwd)/.env:/app/.env \
  -v landppt_data:/app/data \
-  -v landppt_uploads:/app/uploads \
-  landppt
+  -v landppt_reports:/app/research_reports \
+  -v landppt_cache:/app/temp \
+  bradleylzh/landppt:latest

 # View logs
 docker logs -f landppt
 ```

-### Using Docker Compose (Recommended)
+> **Note**: Make sure to create and configure the `.env` file with necessary API keys before running.

-Create `docker-compose.yml` file:

-```yaml
-version: '3.8'
-
-services:
-  landppt:
-    build: .
-    ports:
-      - "8000:8000"
-    volumes:
-      - ./.env:/app/.env
-      - landppt_data:/app/data
-      - landppt_uploads:/app/uploads
-      - landppt_reports:/app/research_reports
-    environment:
-      - PYTHONPATH=/app/src
-    restart: unless-stopped
-    healthcheck:
-      test: ["CMD", "./docker-healthcheck.sh"]
-      interval: 30s
-      timeout: 30s
-      retries: 3
-      start_period: 40s
-
-volumes:
-  landppt_data:
-  landppt_uploads:
-  landppt_reports:
-```
-
-```bash
-# Start services
-docker-compose up -d
-
-# Check status
-docker-compose ps
-
-# View logs
-docker-compose logs -f
-```

 ## 📖 Usage Guide

@@ -220,26 +203,6 @@ After starting the service, visit:
 - **Swagger UI**: `http://localhost:8000/docs`
 - **ReDoc**: `http://localhost:8000/redoc`

-### Main API Endpoints
-
-```bash
-# Health Check
-GET /health
-
-# Project Management
-POST /api/projects          # Create project
-GET /api/projects           # Get project list
-GET /api/projects/{id}      # Get project details
-
-# File Processing
-POST /api/upload            # Upload file
-POST /api/files/upload-and-generate-outline  # Upload and generate outline
-
-# OpenAI Compatible Interface
-POST /v1/chat/completions   # Chat completion
-POST /v1/completions        # Text completion
-```
-
 ## 🛠️ Tech Stack

 ### Backend Technologies
@@ -255,15 +218,12 @@ POST /v1/completions        # Text completion
 - **LangChain**: AI application development framework

 ### File Processing
- **magic-pdf**: Intelligent PDF parsing
+- **mineru**: Intelligent PDF parsing
 - **markitdown**: Multi-format document conversion
- **python-docx**: Word document processing
- **BeautifulSoup**: HTML parsing

 ### Export Functionality
 - **Pyppeteer**: HTML to PDF conversion
 - **Apryse SDK**: PPTX generation
- **Jinja2**: Template rendering

 ## 🤝 Contributing

@@ -276,22 +236,7 @@ We welcome all forms of contributions!
 4. Push to the branch (`git push origin feature/AmazingFeature`)
 5. Open a Pull Request

-### Development Environment Setup
-```bash
-# Clone your fork
-git clone https://github.com/your-username/LandPPT.git
-cd LandPPT
-
-# Install development dependencies
-uv pip install -e ".[dev]"
-
-# Run tests
-pytest
-
-# Code formatting
-black src/
-isort src/
-```
+For details, please see [Contributing Guide](CONTRIBUTING.md).

 ### Reporting Issues
 If you find bugs or have feature suggestions, please create a new issue on the [Issues](https://github.com/sligter/LandPPT/issues) page.
@@ -1,109 +0,0 @@
-version: '3.8'
-
-services:
-  landppt-dev:
-    build: 
-      context: .
-      dockerfile: Dockerfile
-      target: builder  # Use builder stage for development
-    container_name: landppt_dev
-    ports:
-      - "8000:8000"
-    volumes:
-      # Configuration
-      - ./.env:/app/.env:ro
-      # Source code for development (hot reload)
-      - ./src:/app/src
-      - ./run.py:/app/run.py
-      - ./setup_database.py:/app/setup_database.py
-      # Data persistence
-      - landppt_dev_data:/app/data
-      - landppt_dev_uploads:/app/uploads
-      - landppt_dev_reports:/app/research_reports
-      - landppt_dev_cache:/app/temp
-      # Template examples
-      - ./template_examples:/app/template_examples
-    environment:
-      - PYTHONPATH=/app/src
-      - PYTHONUNBUFFERED=1
-      - DEBUG=true
-      - RELOAD=true
-      - LOG_LEVEL=DEBUG
-    restart: unless-stopped
-    command: ["python", "run.py"]
-    networks:
-      - landppt_dev_network
-    depends_on:
-      - redis-dev
-    profiles:
-      - dev
-
-  # Redis for caching in development
-  redis-dev:
-    image: redis:7-alpine
-    container_name: landppt_redis_dev
-    ports:
-      - "6379:6379"
-    volumes:
-      - redis_dev_data:/data
-    restart: unless-stopped
-    networks:
-      - landppt_dev_network
-    profiles:
-      - dev
-
-  # Ollama service for local AI models (development)
-  ollama-dev:
-    image: ollama/ollama:latest
-    container_name: landppt_ollama_dev
-    ports:
-      - "11434:11434"
-    volumes:
-      - ollama_dev_data:/root/.ollama
-    environment:
-      - OLLAMA_HOST=0.0.0.0
-    restart: unless-stopped
-    networks:
-      - landppt_dev_network
-    profiles:
-      - dev-ollama
-    # Uncomment for GPU support
-    # deploy:
-    #   resources:
-    #     reservations:
-    #       devices:
-    #         - driver: nvidia
-    #           count: 1
-    #           capabilities: [gpu]
-
-  # Database management tool (optional)
-  adminer:
-    image: adminer:latest
-    container_name: landppt_adminer
-    ports:
-      - "8080:8080"
-    environment:
-      - ADMINER_DEFAULT_SERVER=landppt-dev
-    restart: unless-stopped
-    networks:
-      - landppt_dev_network
-    profiles:
-      - dev-tools
-
-volumes:
-  landppt_dev_data:
-    driver: local
-  landppt_dev_uploads:
-    driver: local
-  landppt_dev_reports:
-    driver: local
-  landppt_dev_cache:
-    driver: local
-  redis_dev_data:
-    driver: local
-  ollama_dev_data:
-    driver: local
-
-networks:
-  landppt_dev_network:
-    driver: bridge
@@ -2,15 +2,13 @@ version: '3.8'

 services:
  landppt:
-    build: 
-      context: .
-      dockerfile: Dockerfile
+    image: bradleylzh/landppt:latest
    container_name: landppt
    ports:
      - "8000:8000"
    volumes:
      # Configuration
-      - ./.env:/app/.env:ro
+      - ./.env:/app/.env
      # Data persistence
      - landppt_data:/app/data
      - landppt_uploads:/app/uploads
@@ -29,30 +27,6 @@ services:
    networks:
      - landppt_network

-  # Optional: Ollama service for local AI models
-  ollama:
-    image: ollama/ollama:latest
-    container_name: landppt_ollama
-    ports:
-      - "11434:11434"
-    volumes:
-      - ollama_data:/root/.ollama
-    environment:
-      - OLLAMA_HOST=0.0.0.0
-    restart: unless-stopped
-    networks:
-      - landppt_network
-    profiles:
-      - ollama
-    # Uncomment the following lines if you have NVIDIA GPU support
-    # deploy:
-    #   resources:
-    #     reservations:
-    #       devices:
-    #         - driver: nvidia
-    #           count: 1
-    #           capabilities: [gpu]
-
 volumes:
  landppt_data:
    driver: local
@@ -62,8 +36,6 @@ volumes:
    driver: local
  landppt_cache:
    driver: local
-  ollama_data:
-    driver: local

 networks:
  landppt_network:
@@ -0,0 +1,235 @@
+# LandPPT uv 使用指南
+
+## 什么是 uv？
+
+uv 是一个极快的 Python 包管理器和项目管理工具，由 Astral 开发。它是用 Rust 编写的，比传统的 pip 快 10-100 倍，并提供了更好的依赖解析和项目管理功能。
+
+## 为什么选择 uv？
+
+### 🚀 性能优势
+- **极快的安装速度**：比 pip 快 10-100 倍
+- **并行下载**：同时下载多个包
+- **智能缓存**：避免重复下载
+
+### 🔒 可靠性
+- **确定性构建**：uv.lock 文件确保所有环境一致
+- **更好的依赖解析**：避免依赖冲突
+- **版本锁定**：精确控制包版本
+
+### 🛠️ 开发体验
+- **自动虚拟环境管理**：无需手动创建和激活
+- **项目感知**：自动检测项目配置
+- **兼容性**：与 pip 和 PyPI 完全兼容
+
+## LandPPT 中的 uv 配置
+
+### 项目结构
+```
+LandPPT/
+├── pyproject.toml      # 项目配置和依赖定义
+├── uv.toml            # uv 特定配置
+├── uv.lock            # 锁定的依赖版本
+└── .venv/             # 虚拟环境（自动创建）
+```
+
+### 配置文件说明
+
+#### pyproject.toml
+- 定义项目元数据和依赖
+- 包含开发依赖配置
+- 设置项目脚本和入口点
+
+#### uv.toml
+- uv 特定配置
+- 缓存目录设置
+- 额外的包索引配置
+
+#### uv.lock
+- 锁定所有依赖的精确版本
+- 确保跨环境的一致性
+- 自动生成，不应手动编辑
+
+## 常用命令
+
+### 基本操作
+```bash
+# 同步项目依赖（推荐）
+uv sync
+
+# 添加新依赖
+uv add fastapi
+
+# 添加开发依赖
+uv add --dev pytest
+
+# 移除依赖
+uv remove fastapi
+
+# 更新依赖
+uv sync --upgrade
+```
+
+### 运行命令
+```bash
+# 在项目环境中运行Python
+uv run python script.py
+
+# 运行项目脚本
+uv run landppt
+
+# 运行测试
+uv run pytest
+
+# 激活虚拟环境（可选）
+source .venv/bin/activate  # Linux/macOS
+.venv\Scripts\activate     # Windows
+```
+
+### 环境管理
+```bash
+# 创建虚拟环境
+uv venv
+
+# 指定Python版本
+uv venv --python 3.11
+
+# 清理环境
+rm -rf .venv
+uv sync  # 重新创建
+```
+
+## 迁移指南
+
+### 从 pip 迁移到 uv
+
+1. **安装 uv**
+   ```bash
+   # Windows
+   powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
+   
+   # macOS/Linux
+   curl -LsSf https://astral.sh/uv/install.sh | sh
+   ```
+
+2. **同步现有项目**
+   ```bash
+   # 如果有 requirements.txt
+   uv pip install -r requirements.txt
+   
+   # 如果有 pyproject.toml
+   uv sync
+   ```
+
+3. **更新工作流**
+   ```bash
+   # 旧方式
+   pip install package
+   python script.py
+   
+   # 新方式
+   uv add package
+   uv run python script.py
+   ```
+
+## 最佳实践
+
+### 1. 使用 uv sync 而不是 uv install
+```bash
+# 推荐：同步整个项目环境
+uv sync
+
+# 不推荐：只安装单个包
+uv install package
+```
+
+### 2. 提交 uv.lock 文件
+- 确保团队成员使用相同的依赖版本
+- 提供可重现的构建
+
+### 3. 使用 uv run 运行命令
+```bash
+# 推荐：自动使用项目环境
+uv run python script.py
+
+# 可选：手动激活环境
+source .venv/bin/activate
+python script.py
+```
+
+### 4. 分离生产和开发依赖
+```toml
+# pyproject.toml
+[project]
+dependencies = [
+    "fastapi>=0.104.0",
+    # ... 生产依赖
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "black>=23.0.0",
+    # ... 开发依赖
+]
+```
+
+## 故障排除
+
+### 常见问题
+
+1. **uv 命令未找到**
+   - 确保 uv 已正确安装
+   - 重新启动终端或重新加载 PATH
+
+2. **依赖冲突**
+   ```bash
+   # 清理并重新同步
+   rm -rf .venv uv.lock
+   uv sync
+   ```
+
+3. **缓存问题**
+   ```bash
+   # 清理缓存
+   uv cache clean
+   ```
+
+4. **网络问题**
+   ```bash
+   # 使用镜像源
+   uv sync --index-url https://pypi.tuna.tsinghua.edu.cn/simple/
+   ```
+
+### 获取帮助
+```bash
+# 查看帮助
+uv --help
+uv sync --help
+
+# 查看版本
+uv --version
+
+# 诊断信息
+uv pip list
+```
+
+## 与其他工具的比较
+
+| 特性 | uv | pip | poetry | pipenv |
+|------|----|----|--------|--------|
+| 安装速度 | ⭐⭐⭐⭐⭐ | ⭐⭐ | ⭐⭐⭐ | ⭐⭐ |
+| 依赖解析 | ⭐⭐⭐⭐⭐ | ⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐ |
+| 锁文件 | ✅ | ❌ | ✅ | ✅ |
+| 虚拟环境 | ✅ | ❌ | ✅ | ✅ |
+| 项目管理 | ✅ | ❌ | ✅ | ✅ |
+| 学习曲线 | ⭐⭐ | ⭐ | ⭐⭐⭐ | ⭐⭐⭐ |
+
+## 总结
+
+uv 为 LandPPT 项目提供了：
+- 更快的依赖安装和管理
+- 更可靠的环境一致性
+- 更简单的开发工作流
+- 更好的项目管理体验
+
+通过使用 uv，开发者可以专注于代码开发，而不是环境管理问题。
@@ -4,6 +4,21 @@ version = "0.1.0"
 description = "AI-powered PPT generation platform with OpenAI-compatible API"
 readme = "README.md"
 requires-python = ">=3.11"
+license = {text = "Apache-2.0"}
+authors = [
+    {name = "LandPPT Team", email = "contact@landppt.com"},
+]
+keywords = ["ai", "ppt", "presentation", "fastapi", "openai"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: Apache Software License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Office/Business :: Office Suites",
+]
 dependencies = [
    "fastapi>=0.104.0",
    "uvicorn[standard]>=0.24.0",
@@ -53,6 +68,33 @@ dependencies = [
    "pyppeteer>=1.0.2",
 ]

+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "pytest-cov>=4.0.0",
+    "black>=23.0.0",
+    "isort>=5.12.0",
+    "flake8>=6.0.0",
+    "mypy>=1.0.0",
+    "pre-commit>=3.0.0",
+]
+test = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "pytest-cov>=4.0.0",
+    "httpx>=0.25.0",
+]
+
+[project.scripts]
+landppt = "landppt.main:main"
+
+[project.urls]
+Homepage = "https://github.com/sligter/LandPPT"
+Documentation = "https://github.com/sligter/LandPPT#readme"
+Repository = "https://github.com/sligter/LandPPT.git"
+Issues = "https://github.com/sligter/LandPPT/issues"
+
 [build-system]
 requires = ["hatchling"]
 build-backend = "hatchling.build"
@@ -0,0 +1,73 @@
+@echo off
+REM LandPPT Windows 快速设置脚本
+
+echo 🚀 LandPPT Windows 快速设置开始...
+echo ==================================================
+
+REM 检查Python是否安装
+python --version >nul 2>&1
+if %errorlevel% neq 0 (
+    echo ❌ Python未安装或不在PATH中
+    echo 请先安装Python 3.11或更高版本
+    pause
+    exit /b 1
+)
+
+echo ✅ Python已安装
+python --version
+
+REM 检查uv是否安装
+uv --version >nul 2>&1
+if %errorlevel% neq 0 (
+    echo 📦 安装uv...
+    powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+    if %errorlevel% neq 0 (
+        echo ❌ uv安装失败
+        echo 请手动安装uv: https://docs.astral.sh/uv/getting-started/installation/
+        pause
+        exit /b 1
+    )
+    echo ✅ uv安装成功
+) else (
+    echo ✅ uv已安装
+    uv --version
+)
+
+REM 设置环境变量文件
+if not exist .env (
+    if exist .env.example (
+        copy .env.example .env
+        echo ✅ 已创建.env文件
+    ) else (
+        echo ❌ .env.example文件不存在
+        pause
+        exit /b 1
+    )
+) else (
+    echo ℹ️ .env文件已存在，跳过创建
+)
+
+REM 同步依赖
+echo 📦 同步项目依赖...
+uv sync
+if %errorlevel% neq 0 (
+    echo ❌ 依赖同步失败
+    pause
+    exit /b 1
+)
+echo ✅ 依赖同步成功
+
+echo ==================================================
+echo 🎉 LandPPT 设置完成！
+echo.
+echo 下一步:
+echo 1. 编辑 .env 文件，配置你的AI API密钥
+echo 2. 运行服务: uv run python run.py
+echo 3. 访问: http://localhost:8000
+echo.
+echo 开发模式:
+echo - 运行测试: uv run pytest
+echo - 代码格式化: uv run black src/
+echo - 类型检查: uv run mypy src/
+echo.
+pause
@@ -0,0 +1,143 @@
+#!/usr/bin/env python3
+"""
+LandPPT 快速设置脚本
+自动化项目环境设置过程
+"""
+
+import os
+import sys
+import subprocess
+import shutil
+from pathlib import Path
+
+
+def run_command(cmd, check=True, shell=False):
+    """运行命令并处理错误"""
+    try:
+        if shell:
+            result = subprocess.run(cmd, shell=True, check=check, capture_output=True, text=True)
+        else:
+            result = subprocess.run(cmd, check=check, capture_output=True, text=True)
+        return result
+    except subprocess.CalledProcessError as e:
+        print(f"❌ 命令执行失败: {' '.join(cmd) if isinstance(cmd, list) else cmd}")
+        print(f"错误信息: {e.stderr}")
+        return None
+
+
+def check_python_version():
+    """检查Python版本"""
+    print("🔍 检查Python版本...")
+    version = sys.version_info
+    if version.major < 3 or (version.major == 3 and version.minor < 11):
+        print(f"❌ Python版本过低: {version.major}.{version.minor}")
+        print("请安装Python 3.11或更高版本")
+        return False
+    print(f"✅ Python版本: {version.major}.{version.minor}.{version.micro}")
+    return True
+
+
+def check_uv_installed():
+    """检查uv是否已安装"""
+    print("🔍 检查uv是否已安装...")
+    result = run_command(["uv", "--version"], check=False)
+    if result and result.returncode == 0:
+        print(f"✅ uv已安装: {result.stdout.strip()}")
+        return True
+    return False
+
+
+def install_uv():
+    """安装uv"""
+    print("📦 安装uv...")
+    
+    if os.name == 'nt':  # Windows
+        cmd = 'powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"'
+        result = run_command(cmd, shell=True)
+    else:  # macOS/Linux
+        cmd = 'curl -LsSf https://astral.sh/uv/install.sh | sh'
+        result = run_command(cmd, shell=True)
+    
+    if result and result.returncode == 0:
+        print("✅ uv安装成功")
+        return True
+    else:
+        print("❌ uv安装失败，请手动安装")
+        return False
+
+
+def setup_environment():
+    """设置环境变量文件"""
+    print("⚙️ 设置环境变量...")
+    
+    env_example = Path(".env.example")
+    env_file = Path(".env")
+    
+    if not env_example.exists():
+        print("❌ .env.example文件不存在")
+        return False
+    
+    if not env_file.exists():
+        shutil.copy(env_example, env_file)
+        print("✅ 已创建.env文件")
+        print("📝 请编辑.env文件，配置你的AI API密钥")
+    else:
+        print("ℹ️ .env文件已存在，跳过创建")
+    
+    return True
+
+
+def sync_dependencies():
+    """同步依赖"""
+    print("📦 同步项目依赖...")
+    
+    result = run_command(["uv", "sync"])
+    if result and result.returncode == 0:
+        print("✅ 依赖同步成功")
+        return True
+    else:
+        print("❌ 依赖同步失败")
+        return False
+    
+
+
+def main():
+    """主函数"""
+    print("🚀 LandPPT 快速设置开始...")
+    print("=" * 50)
+    
+    # 检查Python版本
+    if not check_python_version():
+        sys.exit(1)
+    
+    # 检查并安装uv
+    if not check_uv_installed():
+        if not install_uv():
+            print("请手动安装uv后重新运行此脚本")
+            sys.exit(1)
+    
+    # 设置环境变量
+    if not setup_environment():
+        sys.exit(1)
+    
+    # 同步依赖
+    if not sync_dependencies():
+        sys.exit(1)
+    
+    
+    print("=" * 50)
+    print("🎉 LandPPT 设置完成！")
+    print()
+    print("下一步:")
+    print("1. 编辑 .env 文件，配置你的AI API密钥")
+    print("2. 运行服务: uv run python run.py")
+    print("3. 访问: http://localhost:8000")
+    print()
+    print("开发模式:")
+    print("- 运行测试: uv run pytest")
+    print("- 代码格式化: uv run black src/")
+    print("- 类型检查: uv run mypy src/")
+
+
+if __name__ == "__main__":
+    main()
@@ -0,0 +1,98 @@
+#!/bin/bash
+# LandPPT Unix/Linux/macOS 快速设置脚本
+
+set -e  # 遇到错误时退出
+
+echo "🚀 LandPPT 快速设置开始..."
+echo "=================================================="
+
+# 检查Python版本
+check_python() {
+    if ! command -v python3 &> /dev/null; then
+        echo "❌ Python3未安装"
+        echo "请先安装Python 3.11或更高版本"
+        exit 1
+    fi
+    
+    python_version=$(python3 -c "import sys; print(f'{sys.version_info.major}.{sys.version_info.minor}')")
+    echo "✅ Python版本: $python_version"
+    
+    # 检查版本是否满足要求
+    if ! python3 -c "import sys; exit(0 if sys.version_info >= (3, 11) else 1)"; then
+        echo "❌ Python版本过低，需要3.11或更高版本"
+        exit 1
+    fi
+}
+
+# 检查并安装uv
+install_uv() {
+    if command -v uv &> /dev/null; then
+        echo "✅ uv已安装: $(uv --version)"
+        return 0
+    fi
+    
+    echo "📦 安装uv..."
+    curl -LsSf https://astral.sh/uv/install.sh | sh
+    
+    # 重新加载PATH
+    export PATH="$HOME/.cargo/bin:$PATH"
+    
+    if command -v uv &> /dev/null; then
+        echo "✅ uv安装成功: $(uv --version)"
+    else
+        echo "❌ uv安装失败"
+        echo "请手动安装uv: https://docs.astral.sh/uv/getting-started/installation/"
+        exit 1
+    fi
+}
+
+# 设置环境变量文件
+setup_env() {
+    echo "⚙️ 设置环境变量..."
+    
+    if [ ! -f ".env.example" ]; then
+        echo "❌ .env.example文件不存在"
+        exit 1
+    fi
+    
+    if [ ! -f ".env" ]; then
+        cp .env.example .env
+        echo "✅ 已创建.env文件"
+        echo "📝 请编辑.env文件，配置你的AI API密钥"
+    else
+        echo "ℹ️ .env文件已存在，跳过创建"
+    fi
+}
+
+# 同步依赖
+sync_deps() {
+    echo "📦 同步项目依赖..."
+    uv sync
+    echo "✅ 依赖同步成功"
+}
+
+# 主函数
+main() {
+    check_python
+    install_uv
+    setup_env
+    sync_deps
+    init_db
+    
+    echo "=================================================="
+    echo "🎉 LandPPT 设置完成！"
+    echo ""
+    echo "下一步:"
+    echo "1. 编辑 .env 文件，配置你的AI API密钥"
+    echo "2. 运行服务: uv run python run.py"
+    echo "3. 访问: http://localhost:8000"
+    echo ""
+    echo "开发模式:"
+    echo "- 运行测试: uv run pytest"
+    echo "- 代码格式化: uv run black src/"
+    echo "- 类型检查: uv run mypy src/"
+    echo ""
+}
+
+# 运行主函数
+main "$@"
@@ -1,354 +0,0 @@
-#!/usr/bin/env python3
-"""
-Database setup script for LandPPT
-Installs dependencies and initializes a clean SQLite database
-"""
-
-import sys
-import os
-import subprocess
-import asyncio
-import logging
-import time
-
-# Add src to path
-sys.path.insert(0, os.path.join(os.path.dirname(__file__), 'src'))
-
-def install_dependencies():
-    """Install required database dependencies"""
-    print("📦 Installing database dependencies...")
-    
-    dependencies = [
-        "sqlalchemy>=2.0.0",
-        "alembic>=1.13.0", 
-        "aiosqlite>=0.19.0"
-    ]
-    
-    try:
-        # Try using uv first (preferred)
-        result = subprocess.run(
-            ["uv", "pip", "install"] + dependencies,
-            capture_output=True,
-            text=True,
-            check=True
-        )
-        print("✅ Dependencies installed successfully with uv")
-        return True
-        
-    except (subprocess.CalledProcessError, FileNotFoundError):
-        print("⚠️  uv not found, trying pip...")
-        
-        try:
-            # Fallback to pip
-            result = subprocess.run(
-                [sys.executable, "-m", "pip", "install"] + dependencies,
-                capture_output=True,
-                text=True,
-                check=True
-            )
-            print("✅ Dependencies installed successfully with pip")
-            return True
-            
-        except subprocess.CalledProcessError as e:
-            print(f"❌ Failed to install dependencies: {e}")
-            print(f"Error output: {e.stderr}")
-            return False
-
-async def initialize_database():
-    """Initialize the database tables"""
-    print("🗄️  Initializing database...")
-    
-    try:
-        from landppt.database.database import init_db
-        
-        # Initialize database
-        await init_db()
-        print("✅ Database initialized successfully")
-        return True
-        
-    except Exception as e:
-        print(f"❌ Failed to initialize database: {e}")
-        return False
-
-async def test_database_connection():
-    """Test database connection and basic operations with thorough cleanup"""
-    print("🔍 Testing database connection...")
-
-    test_project_id = None
-    try:
-        from landppt.database.service import DatabaseService
-        from landppt.database.database import AsyncSessionLocal
-        from landppt.api.models import PPTGenerationRequest
-
-        # Create database session
-        async with AsyncSessionLocal() as session:
-            db_service = DatabaseService(session)
-
-            # Test creating a project
-            test_request = PPTGenerationRequest(
-                scenario="test",
-                topic="Database Test",
-                requirements="Testing database functionality"
-            )
-
-            project = await db_service.create_project(test_request)
-            test_project_id = project.project_id
-            print(f"✅ Test project created: {project.project_id}")
-
-            # Test retrieving the project
-            retrieved_project = await db_service.get_project(project.project_id)
-            if retrieved_project:
-                print("✅ Project retrieval successful")
-            else:
-                print("❌ Project retrieval failed")
-                return False
-
-            # Test listing projects
-            project_list = await db_service.list_projects(page=1, page_size=10)
-            print(f"✅ Found {project_list.total} projects in database")
-
-            # Clean up test project and all related data
-            await db_service.project_repo.delete(project.project_id)
-            print("✅ Test project cleaned up")
-
-            # Verify cleanup was successful
-            verify_project = await db_service.get_project(project.project_id)
-            if verify_project is None:
-                print("✅ Test project cleanup verified")
-            else:
-                print("⚠️  Test project cleanup incomplete")
-
-        print("✅ Database connection test passed")
-        return True
-
-    except Exception as e:
-        print(f"❌ Database connection test failed: {e}")
-
-        # Emergency cleanup if test failed
-        if test_project_id:
-            try:
-                print("🧹 Attempting emergency cleanup...")
-                async with AsyncSessionLocal() as session:
-                    db_service = DatabaseService(session)
-                    await db_service.project_repo.delete(test_project_id)
-                    print("✅ Emergency cleanup completed")
-            except Exception as cleanup_error:
-                print(f"❌ Emergency cleanup failed: {cleanup_error}")
-
-        return False
-
-def check_existing_database():
-    """Check if database already exists"""
-    db_path = "landppt.db"
-    if os.path.exists(db_path):
-        print(f"📋 Found existing database: {db_path}")
-        return True
-    else:
-        print("📋 No existing database found")
-        return False
-
-def remove_existing_database():
-    """Remove existing database file to ensure clean start"""
-    db_path = "landppt.db"
-    if os.path.exists(db_path):
-        try:
-            # Create backup before removal
-            backup_path = f"{db_path}.backup.{int(time.time())}"
-            os.rename(db_path, backup_path)
-            print(f"📋 Existing database backed up to: {backup_path}")
-            print(f"🗑️  Removed existing database: {db_path}")
-            return True
-        except Exception as e:
-            print(f"❌ Failed to remove existing database: {e}")
-            return False
-    else:
-        print("📋 No existing database to remove")
-        return True
-
-async def clear_all_data():
-    """Clear all data from database tables while keeping structure"""
-    print("🧹 Clearing all existing data from database...")
-
-    try:
-        from landppt.database.database import AsyncSessionLocal
-        from sqlalchemy import text
-
-        async with AsyncSessionLocal() as session:
-            # Get all table names
-            result = await session.execute(text(
-                "SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%'"
-            ))
-            tables = [row[0] for row in result.fetchall()]
-
-            if not tables:
-                print("📋 No tables found to clear")
-                return True
-
-            # Disable foreign key constraints temporarily
-            await session.execute(text("PRAGMA foreign_keys = OFF"))
-
-            # Clear all tables
-            cleared_count = 0
-            for table in tables:
-                if table != 'schema_migrations':  # Keep migration history
-                    result = await session.execute(text(f"DELETE FROM {table}"))
-                    cleared_count += result.rowcount
-                    print(f"🧹 Cleared table: {table}")
-
-            # Re-enable foreign key constraints
-            await session.execute(text("PRAGMA foreign_keys = ON"))
-
-            await session.commit()
-            print(f"✅ Cleared {cleared_count} records from {len(tables)} tables")
-            return True
-
-    except Exception as e:
-        print(f"❌ Failed to clear database data: {e}")
-        return False
-
-async def verify_clean_database():
-    """Verify that database tables are empty"""
-    try:
-        from landppt.database.database import AsyncSessionLocal
-        from sqlalchemy import text
-
-        async with AsyncSessionLocal() as session:
-            # Get all table names except migration table
-            result = await session.execute(text(
-                "SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%' AND name != 'schema_migrations'"
-            ))
-            tables = [row[0] for row in result.fetchall()]
-
-            total_records = 0
-            for table in tables:
-                result = await session.execute(text(f"SELECT COUNT(*) FROM {table}"))
-                count = result.scalar()
-                total_records += count
-                if count > 0:
-                    print(f"⚠️  Table {table} contains {count} records")
-
-            if total_records == 0:
-                print("✅ All data tables are empty")
-                return True
-            else:
-                print(f"⚠️  Found {total_records} total records in database")
-                return False
-
-    except Exception as e:
-        print(f"❌ Failed to verify database cleanliness: {e}")
-        return False
-
-async def main(clean_start=True):
-    """Main setup function"""
-    print("🚀 LandPPT Database Setup")
-    print("=" * 50)
-
-    # Check if database already exists
-    db_exists = check_existing_database()
-
-    # Handle existing database
-    if db_exists and clean_start:
-        print("\n🧹 Clean start requested - removing existing database...")
-        if not remove_existing_database():
-            print("❌ Failed to remove existing database")
-            return False
-        print()
-    elif db_exists:
-        print("\n🧹 Clearing existing data from database...")
-        if not await clear_all_data():
-            print("❌ Failed to clear existing data")
-            return False
-        print()
-
-    # Install dependencies
-    if not install_dependencies():
-        print("\n❌ Failed to install dependencies. Please install manually:")
-        print("uv pip install sqlalchemy>=2.0.0 alembic>=1.13.0 aiosqlite>=0.19.0")
-        return False
-
-    print()
-
-    # Initialize database
-    if not await initialize_database():
-        print("\n❌ Database initialization failed")
-        return False
-
-    print()
-
-    # Test database connection (with cleanup)
-    if not await test_database_connection():
-        print("\n❌ Database connection test failed")
-        return False
-
-    # Import default templates from examples (force import for setup)
-    print("\n📋 Importing default templates from examples...")
-    try:
-        from landppt.database.create_default_template import ensure_default_templates_exist_first_time
-        template_ids = await ensure_default_templates_exist_first_time()
-        if template_ids:
-            print(f"✅ Successfully imported {len(template_ids)} templates")
-        else:
-            print("⚠️  No templates were imported")
-    except Exception as e:
-        print(f"❌ Failed to import templates: {e}")
-
-    # Final verification - ensure database is clean
-    print("\n🔍 Final verification - ensuring clean database...")
-    if not await verify_clean_database():
-        print("⚠️  Database may contain residual data")
-    else:
-        print("✅ Database is clean and ready")
-
-    print()
-    print("🎉 Database setup completed successfully!")
-    print("📋 Database initialized with clean, empty tables")
-    print()
-    print("📝 Next steps:")
-    print("1. Start the server: python start_server.py")
-    print("2. Access the web interface: http://localhost:8000/web")
-    print("3. Check API docs: http://localhost:8000/docs")
-    print()
-    print("💾 Database file: landppt.db")
-    print("🔧 Configuration: .env")
-
-    return True
-
-if __name__ == "__main__":
-    import argparse
-
-    parser = argparse.ArgumentParser(description="LandPPT Database Setup")
-    parser.add_argument(
-        "--keep-data",
-        action="store_true",
-        help="Keep existing data instead of creating clean database"
-    )
-    parser.add_argument(
-        "--clear-only",
-        action="store_true",
-        help="Only clear existing data without full reset"
-    )
-
-    args = parser.parse_args()
-
-    try:
-        if args.clear_only:
-            # Only clear data from existing database
-            print("🧹 Clearing existing database data...")
-            success = asyncio.run(clear_all_data())
-            if success:
-                print("✅ Database data cleared successfully")
-                success = asyncio.run(verify_clean_database())
-            else:
-                print("❌ Failed to clear database data")
-        else:
-            # Full setup with optional clean start
-            clean_start = not args.keep_data
-            success = asyncio.run(main(clean_start=clean_start))
-
-        sys.exit(0 if success else 1)
-    except KeyboardInterrupt:
-        print("\n👋 Setup cancelled by user")
-        sys.exit(1)
-    except Exception as e:
-        print(f"\n❌ Unexpected error: {e}")
-        sys.exit(1)
@@ -80,7 +80,9 @@ class PPTService:
        topic = request.topic
        scenario = request.scenario
        language = request.language
-        
+        ppt_style = request.ppt_style
+        custom_style_prompt = request.custom_style_prompt
+        description = request.description
        # Generate slides based on scenario
        slides = []
        
@@ -99,7 +101,7 @@ class PPTService:
            "type": "agenda",
            "title": "目录" if language == "zh" else "Agenda",
            "subtitle": "",
-            "content": self._generate_agenda_content(scenario, language)
+            "content": self._generate_agenda_content(scenario, language,)
        })
        
        # Content slides based on scenario
@@ -379,13 +379,6 @@
                配置Apryse License Key以启用专业的PPTX文件导出功能。
            </p>
        </div>
-
-        <div>
-            <h4 style="color: #e74c3c; margin-bottom: 10px;">🔄 服务重启</h4>
-            <p style="color: #7f8c8d; line-height: 1.6;">
-                当配置更改需要重启生效时，可使用重启服务功能。重启过程中所有连接将断开。
-            </p>
-        </div>
    </div>

    <div style="margin-top: 30px; text-align: center;">
@@ -1,54 +1,23 @@
 version = 1
 requires-python = ">=3.11"
 resolution-markers = [
-    "python_full_version >= '3.13' and platform_system == 'Darwin' and sys_platform == 'darwin'",
-    "python_full_version >= '3.13' and platform_machine == 'aarch64' and platform_system == 'Linux' and sys_platform == 'darwin'",
-    "(python_full_version >= '3.13' and platform_machine != 'aarch64' and platform_system != 'Darwin' and sys_platform == 'darwin') or (python_full_version >= '3.13' and platform_system != 'Darwin' and platform_system != 'Linux' and sys_platform == 'darwin')",
-    "python_full_version >= '3.13' and platform_machine == 'aarch64' and platform_system == 'Darwin' and sys_platform == 'linux'",
-    "python_full_version >= '3.13' and platform_machine == 'aarch64' and platform_system == 'Linux' and sys_platform == 'linux'",
-    "python_full_version >= '3.13' and platform_machine == 'aarch64' and platform_system != 'Darwin' and platform_system != 'Linux' and sys_platform == 'linux'",
-    "python_full_version >= '3.13' and platform_system == 'Darwin' and sys_platform == 'win32'",
-    "python_full_version >= '3.13' and platform_machine == 'aarch64' and platform_system == 'Linux' and sys_platform == 'win32'",
-    "(python_full_version >= '3.13' and platform_machine != 'aarch64' and platform_system != 'Darwin' and sys_platform == 'win32') or (python_full_version >= '3.13' and platform_system != 'Darwin' and platform_system != 'Linux' and sys_platform == 'win32')",
-    "(python_full_version >= '3.13' and platform_machine != 'aarch64' and platform_system == 'Darwin' and sys_platform != 'darwin' and sys_platform != 'win32') or (python_full_version >= '3.13' and platform_system == 'Darwin' and sys_platform != 'darwin' and sys_platform != 'linux' and sys_platform != 'win32')",
-    "python_full_version >= '3.13' and platform_machine == 'aarch64' and platform_system == 'Linux' and sys_platform != 'darwin' and sys_platform != 'linux' and sys_platform != 'win32'",
-    "(python_full_version >= '3.13' and platform_machine != 'aarch64' and platform_system != 'Darwin' and sys_platform != 'darwin' and sys_platform != 'win32') or (python_full_version >= '3.13' and platform_system != 'Darwin' and platform_system != 'Linux' and sys_platform != 'darwin' and sys_platform != 'linux' and sys_platform != 'win32')",
-    "python_full_version >= '3.12.4' and python_full_version < '3.13' and platform_system == 'Darwin' and sys_platform == 'darwin'",
-    "python_full_version >= '3.12.4' and python_full_version < '3.13' and platform_machine == 'aarch64' and platform_system == 'Linux' and sys_platform == 'darwin'",
-    "(python_full_version >= '3.12.4' and python_full_version < '3.13' and platform_machine != 'aarch64' and platform_system != 'Darwin' and sys_platform == 'darwin') or (python_full_version >= '3.12.4' and python_full_version < '3.13' and platform_system != 'Darwin' and platform_system != 'Linux' and sys_platform == 'darwin')",
-    "python_full_version >= '3.12.4' and python_full_version < '3.13' and platform_machine == 'aarch64' and platform_system == 'Darwin' and sys_platform == 'linux'",
-    "python_full_version >= '3.12.4' and python_full_version < '3.13' and platform_machine == 'aarch64' and platform_system == 'Linux' and sys_platform == 'linux'",
-    "python_full_version >= '3.12.4' and python_full_version < '3.13' and platform_machine == 'aarch64' and platform_system != 'Darwin' and platform_system != 'Linux' and sys_platform == 'linux'",
-    "python_full_version >= '3.12.4' and python_full_version < '3.13' and platform_system == 'Darwin' and sys_platform == 'win32'",
-    "python_full_version >= '3.12.4' and python_full_version < '3.13' and platform_machine == 'aarch64' and platform_system == 'Linux' and sys_platform == 'win32'",
-    "(python_full_version >= '3.12.4' and python_full_version < '3.13' and platform_machine != 'aarch64' and platform_system != 'Darwin' and sys_platform == 'win32') or (python_full_version >= '3.12.4' and python_full_version < '3.13' and platform_system != 'Darwin' and platform_system != 'Linux' and sys_platform == 'win32')",
-    "(python_full_version >= '3.12.4' and python_full_version < '3.13' and platform_machine != 'aarch64' and platform_system == 'Darwin' and sys_platform != 'darwin' and sys_platform != 'win32') or (python_full_version >= '3.12.4' and python_full_version < '3.13' and platform_system == 'Darwin' and sys_platform != 'darwin' and sys_platform != 'linux' and sys_platform != 'win32')",
-    "python_full_version >= '3.12.4' and python_full_version < '3.13' and platform_machine == 'aarch64' and platform_system == 'Linux' and sys_platform != 'darwin' and sys_platform != 'linux' and sys_platform != 'win32'",
-    "(python_full_version >= '3.12.4' and python_full_version < '3.13' and platform_machine != 'aarch64' and platform_system != 'Darwin' and sys_platform != 'darwin' and sys_platform != 'win32') or (python_full_version >= '3.12.4' and python_full_version < '3.13' and platform_system != 'Darwin' and platform_system != 'Linux' and sys_platform != 'darwin' and sys_platform != 'linux' and sys_platform != 'win32')",
-    "python_full_version >= '3.12' and python_full_version < '3.12.4' and platform_system == 'Darwin' and sys_platform == 'darwin'",
-    "python_full_version >= '3.12' and python_full_version < '3.12.4' and platform_machine == 'aarch64' and platform_system == 'Linux' and sys_platform == 'darwin'",
-    "(python_full_version >= '3.12' and python_full_version < '3.12.4' and platform_machine != 'aarch64' and platform_system != 'Darwin' and sys_platform == 'darwin') or (python_full_version >= '3.12' and python_full_version < '3.12.4' and platform_system != 'Darwin' and platform_system != 'Linux' and sys_platform == 'darwin')",
-    "python_full_version >= '3.12' and python_full_version < '3.12.4' and platform_machine == 'aarch64' and platform_system == 'Darwin' and sys_platform == 'linux'",
-    "python_full_version >= '3.12' and python_full_version < '3.12.4' and platform_machine == 'aarch64' and platform_system == 'Linux' and sys_platform == 'linux'",
-    "python_full_version >= '3.12' and python_full_version < '3.12.4' and platform_machine == 'aarch64' and platform_system != 'Darwin' and platform_system != 'Linux' and sys_platform == 'linux'",
-    "python_full_version >= '3.12' and python_full_version < '3.12.4' and platform_system == 'Darwin' and sys_platform == 'win32'",
-    "python_full_version >= '3.12' and python_full_version < '3.12.4' and platform_machine == 'aarch64' and platform_system == 'Linux' and sys_platform == 'win32'",
-    "(python_full_version >= '3.12' and python_full_version < '3.12.4' and platform_machine != 'aarch64' and platform_system != 'Darwin' and sys_platform == 'win32') or (python_full_version >= '3.12' and python_full_version < '3.12.4' and platform_system != 'Darwin' and platform_system != 'Linux' and sys_platform == 'win32')",
-    "(python_full_version >= '3.12' and python_full_version < '3.12.4' and platform_machine != 'aarch64' and platform_system == 'Darwin' and sys_platform != 'darwin' and sys_platform != 'win32') or (python_full_version >= '3.12' and python_full_version < '3.12.4' and platform_system == 'Darwin' and sys_platform != 'darwin' and sys_platform != 'linux' and sys_platform != 'win32')",
-    "python_full_version >= '3.12' and python_full_version < '3.12.4' and platform_machine == 'aarch64' and platform_system == 'Linux' and sys_platform != 'darwin' and sys_platform != 'linux' and sys_platform != 'win32'",
-    "(python_full_version >= '3.12' and python_full_version < '3.12.4' and platform_machine != 'aarch64' and platform_system != 'Darwin' and sys_platform != 'darwin' and sys_platform != 'win32') or (python_full_version >= '3.12' and python_full_version < '3.12.4' and platform_system != 'Darwin' and platform_system != 'Linux' and sys_platform != 'darwin' and sys_platform != 'linux' and sys_platform != 'win32')",
-    "python_full_version < '3.12' and platform_system == 'Darwin' and sys_platform == 'darwin'",
-    "python_full_version < '3.12' and platform_machine == 'aarch64' and platform_system == 'Linux' and sys_platform == 'darwin'",
-    "(python_full_version < '3.12' and platform_machine != 'aarch64' and platform_system != 'Darwin' and sys_platform == 'darwin') or (python_full_version < '3.12' and platform_system != 'Darwin' and platform_system != 'Linux' and sys_platform == 'darwin')",
-    "python_full_version < '3.12' and platform_machine == 'aarch64' and platform_system == 'Darwin' and sys_platform == 'linux'",
-    "python_full_version < '3.12' and platform_machine == 'aarch64' and platform_system == 'Linux' and sys_platform == 'linux'",
-    "python_full_version < '3.12' and platform_machine == 'aarch64' and platform_system != 'Darwin' and platform_system != 'Linux' and sys_platform == 'linux'",
-    "python_full_version < '3.12' and platform_system == 'Darwin' and sys_platform == 'win32'",
-    "python_full_version < '3.12' and platform_machine == 'aarch64' and platform_system == 'Linux' and sys_platform == 'win32'",
-    "(python_full_version < '3.12' and platform_machine != 'aarch64' and platform_system != 'Darwin' and sys_platform == 'win32') or (python_full_version < '3.12' and platform_system != 'Darwin' and platform_system != 'Linux' and sys_platform == 'win32')",
-    "(python_full_version < '3.12' and platform_machine != 'aarch64' and platform_system == 'Darwin' and sys_platform != 'darwin' and sys_platform != 'win32') or (python_full_version < '3.12' and platform_system == 'Darwin' and sys_platform != 'darwin' and sys_platform != 'linux' and sys_platform != 'win32')",
-    "python_full_version < '3.12' and platform_machine == 'aarch64' and platform_system == 'Linux' and sys_platform != 'darwin' and sys_platform != 'linux' and sys_platform != 'win32'",
-    "(python_full_version < '3.12' and platform_machine != 'aarch64' and platform_system != 'Darwin' and sys_platform != 'darwin' and sys_platform != 'win32') or (python_full_version < '3.12' and platform_system != 'Darwin' and platform_system != 'Linux' and sys_platform != 'darwin' and sys_platform != 'linux' and sys_platform != 'win32')",
+    "python_full_version >= '3.13' and sys_platform == 'darwin'",
+    "python_version < '0'",
+    "python_full_version >= '3.13' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "python_full_version >= '3.13' and sys_platform == 'win32'",
+    "(python_full_version >= '3.13' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version >= '3.13' and sys_platform != 'darwin' and sys_platform != 'linux' and sys_platform != 'win32')",
+    "python_full_version >= '3.12.4' and python_full_version < '3.13' and sys_platform == 'darwin'",
+    "python_full_version >= '3.12.4' and python_full_version < '3.13' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "python_full_version >= '3.12.4' and python_full_version < '3.13' and sys_platform == 'win32'",
+    "(python_full_version >= '3.12.4' and python_full_version < '3.13' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version >= '3.12.4' and python_full_version < '3.13' and sys_platform != 'darwin' and sys_platform != 'linux' and sys_platform != 'win32')",
+    "python_full_version >= '3.12' and python_full_version < '3.12.4' and sys_platform == 'darwin'",
+    "python_full_version >= '3.12' and python_full_version < '3.12.4' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "python_full_version >= '3.12' and python_full_version < '3.12.4' and sys_platform == 'win32'",
+    "(python_full_version >= '3.12' and python_full_version < '3.12.4' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version >= '3.12' and python_full_version < '3.12.4' and sys_platform != 'darwin' and sys_platform != 'linux' and sys_platform != 'win32')",
+    "python_full_version < '3.12' and sys_platform == 'darwin'",
+    "python_full_version < '3.12' and platform_machine == 'aarch64' and sys_platform == 'linux'",
+    "python_full_version < '3.12' and sys_platform == 'win32'",
+    "(python_full_version < '3.12' and platform_machine != 'aarch64' and sys_platform == 'linux') or (python_full_version < '3.12' and sys_platform != 'darwin' and sys_platform != 'linux' and sys_platform != 'win32')",
 ]

 [[package]]
@@ -441,6 +410,34 @@ wheels = [
    { url = "https://files.pythonhosted.org/packages/50/cd/30110dc0ffcf3b131156077b90e9f60ed75711223f306da4db08eff8403b/beautifulsoup4-4.13.4-py3-none-any.whl", hash = "sha256:9bbbb14bfde9d79f38b8cd5f8c7c85f4b8f2523190ebed90e950a8dea4cb1c4b", size = 187285 },
 ]

+[[package]]
+name = "black"
+version = "25.1.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "click" },
+    { name = "mypy-extensions" },
+    { name = "packaging" },
+    { name = "pathspec" },
+    { name = "platformdirs" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/94/49/26a7b0f3f35da4b5a65f081943b7bcd22d7002f5f0fb8098ec1ff21cb6ef/black-25.1.0.tar.gz", hash = "sha256:33496d5cd1222ad73391352b4ae8da15253c5de89b93a80b3e2c8d9a19ec2666", size = 649449 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/7e/4f/87f596aca05c3ce5b94b8663dbfe242a12843caaa82dd3f85f1ffdc3f177/black-25.1.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:a39337598244de4bae26475f77dda852ea00a93bd4c728e09eacd827ec929df0", size = 1614372 },
+    { url = "https://files.pythonhosted.org/packages/e7/d0/2c34c36190b741c59c901e56ab7f6e54dad8df05a6272a9747ecef7c6036/black-25.1.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:96c1c7cd856bba8e20094e36e0f948718dc688dba4a9d78c3adde52b9e6c2299", size = 1442865 },
+    { url = "https://files.pythonhosted.org/packages/21/d4/7518c72262468430ead45cf22bd86c883a6448b9eb43672765d69a8f1248/black-25.1.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:bce2e264d59c91e52d8000d507eb20a9aca4a778731a08cfff7e5ac4a4bb7096", size = 1749699 },
+    { url = "https://files.pythonhosted.org/packages/58/db/4f5beb989b547f79096e035c4981ceb36ac2b552d0ac5f2620e941501c99/black-25.1.0-cp311-cp311-win_amd64.whl", hash = "sha256:172b1dbff09f86ce6f4eb8edf9dede08b1fce58ba194c87d7a4f1a5aa2f5b3c2", size = 1428028 },
+    { url = "https://files.pythonhosted.org/packages/83/71/3fe4741df7adf015ad8dfa082dd36c94ca86bb21f25608eb247b4afb15b2/black-25.1.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:4b60580e829091e6f9238c848ea6750efed72140b91b048770b64e74fe04908b", size = 1650988 },
+    { url = "https://files.pythonhosted.org/packages/13/f3/89aac8a83d73937ccd39bbe8fc6ac8860c11cfa0af5b1c96d081facac844/black-25.1.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:1e2978f6df243b155ef5fa7e558a43037c3079093ed5d10fd84c43900f2d8ecc", size = 1453985 },
+    { url = "https://files.pythonhosted.org/packages/6f/22/b99efca33f1f3a1d2552c714b1e1b5ae92efac6c43e790ad539a163d1754/black-25.1.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:3b48735872ec535027d979e8dcb20bf4f70b5ac75a8ea99f127c106a7d7aba9f", size = 1783816 },
+    { url = "https://files.pythonhosted.org/packages/18/7e/a27c3ad3822b6f2e0e00d63d58ff6299a99a5b3aee69fa77cd4b0076b261/black-25.1.0-cp312-cp312-win_amd64.whl", hash = "sha256:ea0213189960bda9cf99be5b8c8ce66bb054af5e9e861249cd23471bd7b0b3ba", size = 1440860 },
+    { url = "https://files.pythonhosted.org/packages/98/87/0edf98916640efa5d0696e1abb0a8357b52e69e82322628f25bf14d263d1/black-25.1.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:8f0b18a02996a836cc9c9c78e5babec10930862827b1b724ddfe98ccf2f2fe4f", size = 1650673 },
+    { url = "https://files.pythonhosted.org/packages/52/e5/f7bf17207cf87fa6e9b676576749c6b6ed0d70f179a3d812c997870291c3/black-25.1.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:afebb7098bfbc70037a053b91ae8437c3857482d3a690fefc03e9ff7aa9a5fd3", size = 1453190 },
+    { url = "https://files.pythonhosted.org/packages/e3/ee/adda3d46d4a9120772fae6de454c8495603c37c4c3b9c60f25b1ab6401fe/black-25.1.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:030b9759066a4ee5e5aca28c3c77f9c64789cdd4de8ac1df642c40b708be6171", size = 1782926 },
+    { url = "https://files.pythonhosted.org/packages/cc/64/94eb5f45dcb997d2082f097a3944cfc7fe87e071907f677e80788a2d7b7a/black-25.1.0-cp313-cp313-win_amd64.whl", hash = "sha256:a22f402b410566e2d1c950708c77ebf5ebd5d0d88a6a2e87c86d9fb48afa0d18", size = 1442613 },
+    { url = "https://files.pythonhosted.org/packages/09/71/54e999902aed72baf26bca0d50781b01838251a462612966e9fc4891eadd/black-25.1.0-py3-none-any.whl", hash = "sha256:95e8176dae143ba9097f351d174fdaf0ccd29efb414b362ae3fd72bf0f710717", size = 207646 },
+]
+
 [[package]]
 name = "boto3"
 version = "1.38.43"
@@ -532,6 +529,15 @@ wheels = [
    { url = "https://files.pythonhosted.org/packages/7c/fc/6a8cb64e5f0324877d503c854da15d76c1e50eb722e320b15345c4d0c6de/cffi-1.17.1-cp313-cp313-win_amd64.whl", hash = "sha256:f6a16c31041f09ead72d69f583767292f750d24913dadacf5756b966aacb3f1a", size = 182009 },
 ]

+[[package]]
+name = "cfgv"
+version = "3.4.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/11/74/539e56497d9bd1d484fd863dd69cbbfa653cd2aa27abfe35653494d85e94/cfgv-3.4.0.tar.gz", hash = "sha256:e52591d4c5f5dead8e0f673fb16db7949d2cfb3f7da4582893288f0ded8fe560", size = 7114 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c5/55/51844dd50c4fc7a33b653bfaba4c2456f06955289ca770a5dbd5fd267374/cfgv-3.4.0-py2.py3-none-any.whl", hash = "sha256:b7265b1f29fd3316bfcd2b330d63d024f2bfd8bcb8b0272f8e19a504856c48f9", size = 7249 },
+]
+
 [[package]]
 name = "chardet"
 version = "5.2.0"
@@ -594,7 +600,7 @@ name = "click"
 version = "8.2.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "colorama", marker = "platform_system == 'Windows'" },
+    { name = "colorama", marker = "sys_platform == 'win32'" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/60/6c/8ca2efa64cf75a977a0d7fac081354553ebe483345c734fb6b6515d96bbc/click-8.2.1.tar.gz", hash = "sha256:27c491cc05d968d271d5a1db13e3b5a184636d9d930f148c50b038f0d0646202", size = 286342 }
 wheels = [
@@ -697,6 +703,65 @@ wheels = [
    { url = "https://files.pythonhosted.org/packages/87/68/7f46fb537958e87427d98a4074bcde4b67a70b04900cfc5ce29bc2f556c1/contourpy-1.3.2-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:8c5acb8dddb0752bf252e01a3035b21443158910ac16a3b0d20e7fed7d534ce5", size = 221791 },
 ]

+[[package]]
+name = "coverage"
+version = "7.9.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/e7/e0/98670a80884f64578f0c22cd70c5e81a6e07b08167721c7487b4d70a7ca0/coverage-7.9.1.tar.gz", hash = "sha256:6cf43c78c4282708a28e466316935ec7489a9c487518a77fa68f716c67909cec", size = 813650 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/60/34/fa69372a07d0903a78ac103422ad34db72281c9fc625eba94ac1185da66f/coverage-7.9.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:95c765060e65c692da2d2f51a9499c5e9f5cf5453aeaf1420e3fc847cc060582", size = 212146 },
+    { url = "https://files.pythonhosted.org/packages/27/f0/da1894915d2767f093f081c42afeba18e760f12fdd7a2f4acbe00564d767/coverage-7.9.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:ba383dc6afd5ec5b7a0d0c23d38895db0e15bcba7fb0fa8901f245267ac30d86", size = 212536 },
+    { url = "https://files.pythonhosted.org/packages/10/d5/3fc33b06e41e390f88eef111226a24e4504d216ab8e5d1a7089aa5a3c87a/coverage-7.9.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:37ae0383f13cbdcf1e5e7014489b0d71cc0106458878ccde52e8a12ced4298ed", size = 245092 },
+    { url = "https://files.pythonhosted.org/packages/0a/39/7aa901c14977aba637b78e95800edf77f29f5a380d29768c5b66f258305b/coverage-7.9.1-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:69aa417a030bf11ec46149636314c24c8d60fadb12fc0ee8f10fda0d918c879d", size = 242806 },
+    { url = "https://files.pythonhosted.org/packages/43/fc/30e5cfeaf560b1fc1989227adedc11019ce4bb7cce59d65db34fe0c2d963/coverage-7.9.1-cp311-cp311-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0a4be2a28656afe279b34d4f91c3e26eccf2f85500d4a4ff0b1f8b54bf807338", size = 244610 },
+    { url = "https://files.pythonhosted.org/packages/bf/15/cca62b13f39650bc87b2b92bb03bce7f0e79dd0bf2c7529e9fc7393e4d60/coverage-7.9.1-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:382e7ddd5289f140259b610e5f5c58f713d025cb2f66d0eb17e68d0a94278875", size = 244257 },
+    { url = "https://files.pythonhosted.org/packages/cd/1a/c0f2abe92c29e1464dbd0ff9d56cb6c88ae2b9e21becdb38bea31fcb2f6c/coverage-7.9.1-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:e5532482344186c543c37bfad0ee6069e8ae4fc38d073b8bc836fc8f03c9e250", size = 242309 },
+    { url = "https://files.pythonhosted.org/packages/57/8d/c6fd70848bd9bf88fa90df2af5636589a8126d2170f3aade21ed53f2b67a/coverage-7.9.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:a39d18b3f50cc121d0ce3838d32d58bd1d15dab89c910358ebefc3665712256c", size = 242898 },
+    { url = "https://files.pythonhosted.org/packages/c2/9e/6ca46c7bff4675f09a66fe2797cd1ad6a24f14c9c7c3b3ebe0470a6e30b8/coverage-7.9.1-cp311-cp311-win32.whl", hash = "sha256:dd24bd8d77c98557880def750782df77ab2b6885a18483dc8588792247174b32", size = 214561 },
+    { url = "https://files.pythonhosted.org/packages/a1/30/166978c6302010742dabcdc425fa0f938fa5a800908e39aff37a7a876a13/coverage-7.9.1-cp311-cp311-win_amd64.whl", hash = "sha256:6b55ad10a35a21b8015eabddc9ba31eb590f54adc9cd39bcf09ff5349fd52125", size = 215493 },
+    { url = "https://files.pythonhosted.org/packages/60/07/a6d2342cd80a5be9f0eeab115bc5ebb3917b4a64c2953534273cf9bc7ae6/coverage-7.9.1-cp311-cp311-win_arm64.whl", hash = "sha256:6ad935f0016be24c0e97fc8c40c465f9c4b85cbbe6eac48934c0dc4d2568321e", size = 213869 },
+    { url = "https://files.pythonhosted.org/packages/68/d9/7f66eb0a8f2fce222de7bdc2046ec41cb31fe33fb55a330037833fb88afc/coverage-7.9.1-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:a8de12b4b87c20de895f10567639c0797b621b22897b0af3ce4b4e204a743626", size = 212336 },
+    { url = "https://files.pythonhosted.org/packages/20/20/e07cb920ef3addf20f052ee3d54906e57407b6aeee3227a9c91eea38a665/coverage-7.9.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:5add197315a054e92cee1b5f686a2bcba60c4c3e66ee3de77ace6c867bdee7cb", size = 212571 },
+    { url = "https://files.pythonhosted.org/packages/78/f8/96f155de7e9e248ca9c8ff1a40a521d944ba48bec65352da9be2463745bf/coverage-7.9.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:600a1d4106fe66f41e5d0136dfbc68fe7200a5cbe85610ddf094f8f22e1b0300", size = 246377 },
+    { url = "https://files.pythonhosted.org/packages/3e/cf/1d783bd05b7bca5c10ded5f946068909372e94615a4416afadfe3f63492d/coverage-7.9.1-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:2a876e4c3e5a2a1715a6608906aa5a2e0475b9c0f68343c2ada98110512ab1d8", size = 243394 },
+    { url = "https://files.pythonhosted.org/packages/02/dd/e7b20afd35b0a1abea09fb3998e1abc9f9bd953bee548f235aebd2b11401/coverage-7.9.1-cp312-cp312-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:81f34346dd63010453922c8e628a52ea2d2ccd73cb2487f7700ac531b247c8a5", size = 245586 },
+    { url = "https://files.pythonhosted.org/packages/4e/38/b30b0006fea9d617d1cb8e43b1bc9a96af11eff42b87eb8c716cf4d37469/coverage-7.9.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:888f8eee13f2377ce86d44f338968eedec3291876b0b8a7289247ba52cb984cd", size = 245396 },
+    { url = "https://files.pythonhosted.org/packages/31/e4/4d8ec1dc826e16791f3daf1b50943e8e7e1eb70e8efa7abb03936ff48418/coverage-7.9.1-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:9969ef1e69b8c8e1e70d591f91bbc37fc9a3621e447525d1602801a24ceda898", size = 243577 },
+    { url = "https://files.pythonhosted.org/packages/25/f4/b0e96c5c38e6e40ef465c4bc7f138863e2909c00e54a331da335faf0d81a/coverage-7.9.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:60c458224331ee3f1a5b472773e4a085cc27a86a0b48205409d364272d67140d", size = 244809 },
+    { url = "https://files.pythonhosted.org/packages/8a/65/27e0a1fa5e2e5079bdca4521be2f5dabf516f94e29a0defed35ac2382eb2/coverage-7.9.1-cp312-cp312-win32.whl", hash = "sha256:5f646a99a8c2b3ff4c6a6e081f78fad0dde275cd59f8f49dc4eab2e394332e74", size = 214724 },
+    { url = "https://files.pythonhosted.org/packages/9b/a8/d5b128633fd1a5e0401a4160d02fa15986209a9e47717174f99dc2f7166d/coverage-7.9.1-cp312-cp312-win_amd64.whl", hash = "sha256:30f445f85c353090b83e552dcbbdad3ec84c7967e108c3ae54556ca69955563e", size = 215535 },
+    { url = "https://files.pythonhosted.org/packages/a3/37/84bba9d2afabc3611f3e4325ee2c6a47cd449b580d4a606b240ce5a6f9bf/coverage-7.9.1-cp312-cp312-win_arm64.whl", hash = "sha256:af41da5dca398d3474129c58cb2b106a5d93bbb196be0d307ac82311ca234342", size = 213904 },
+    { url = "https://files.pythonhosted.org/packages/d0/a7/a027970c991ca90f24e968999f7d509332daf6b8c3533d68633930aaebac/coverage-7.9.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:31324f18d5969feef7344a932c32428a2d1a3e50b15a6404e97cba1cc9b2c631", size = 212358 },
+    { url = "https://files.pythonhosted.org/packages/f2/48/6aaed3651ae83b231556750280682528fea8ac7f1232834573472d83e459/coverage-7.9.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:0c804506d624e8a20fb3108764c52e0eef664e29d21692afa375e0dd98dc384f", size = 212620 },
+    { url = "https://files.pythonhosted.org/packages/6c/2a/f4b613f3b44d8b9f144847c89151992b2b6b79cbc506dee89ad0c35f209d/coverage-7.9.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ef64c27bc40189f36fcc50c3fb8f16ccda73b6a0b80d9bd6e6ce4cffcd810bbd", size = 245788 },
+    { url = "https://files.pythonhosted.org/packages/04/d2/de4fdc03af5e4e035ef420ed26a703c6ad3d7a07aff2e959eb84e3b19ca8/coverage-7.9.1-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:d4fe2348cc6ec372e25adec0219ee2334a68d2f5222e0cba9c0d613394e12d86", size = 243001 },
+    { url = "https://files.pythonhosted.org/packages/f5/e8/eed18aa5583b0423ab7f04e34659e51101135c41cd1dcb33ac1d7013a6d6/coverage-7.9.1-cp313-cp313-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:34ed2186fe52fcc24d4561041979a0dec69adae7bce2ae8d1c49eace13e55c43", size = 244985 },
+    { url = "https://files.pythonhosted.org/packages/17/f8/ae9e5cce8885728c934eaa58ebfa8281d488ef2afa81c3dbc8ee9e6d80db/coverage-7.9.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:25308bd3d00d5eedd5ae7d4357161f4df743e3c0240fa773ee1b0f75e6c7c0f1", size = 245152 },
+    { url = "https://files.pythonhosted.org/packages/5a/c8/272c01ae792bb3af9b30fac14d71d63371db227980682836ec388e2c57c0/coverage-7.9.1-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:73e9439310f65d55a5a1e0564b48e34f5369bee943d72c88378f2d576f5a5751", size = 243123 },
+    { url = "https://files.pythonhosted.org/packages/8c/d0/2819a1e3086143c094ab446e3bdf07138527a7b88cb235c488e78150ba7a/coverage-7.9.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:37ab6be0859141b53aa89412a82454b482c81cf750de4f29223d52268a86de67", size = 244506 },
+    { url = "https://files.pythonhosted.org/packages/8b/4e/9f6117b89152df7b6112f65c7a4ed1f2f5ec8e60c4be8f351d91e7acc848/coverage-7.9.1-cp313-cp313-win32.whl", hash = "sha256:64bdd969456e2d02a8b08aa047a92d269c7ac1f47e0c977675d550c9a0863643", size = 214766 },
+    { url = "https://files.pythonhosted.org/packages/27/0f/4b59f7c93b52c2c4ce7387c5a4e135e49891bb3b7408dcc98fe44033bbe0/coverage-7.9.1-cp313-cp313-win_amd64.whl", hash = "sha256:be9e3f68ca9edb897c2184ad0eee815c635565dbe7a0e7e814dc1f7cbab92c0a", size = 215568 },
+    { url = "https://files.pythonhosted.org/packages/09/1e/9679826336f8c67b9c39a359352882b24a8a7aee48d4c9cad08d38d7510f/coverage-7.9.1-cp313-cp313-win_arm64.whl", hash = "sha256:1c503289ffef1d5105d91bbb4d62cbe4b14bec4d13ca225f9c73cde9bb46207d", size = 213939 },
+    { url = "https://files.pythonhosted.org/packages/bb/5b/5c6b4e7a407359a2e3b27bf9c8a7b658127975def62077d441b93a30dbe8/coverage-7.9.1-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:0b3496922cb5f4215bf5caaef4cf12364a26b0be82e9ed6d050f3352cf2d7ef0", size = 213079 },
+    { url = "https://files.pythonhosted.org/packages/a2/22/1e2e07279fd2fd97ae26c01cc2186e2258850e9ec125ae87184225662e89/coverage-7.9.1-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:9565c3ab1c93310569ec0d86b017f128f027cab0b622b7af288696d7ed43a16d", size = 213299 },
+    { url = "https://files.pythonhosted.org/packages/14/c0/4c5125a4b69d66b8c85986d3321520f628756cf524af810baab0790c7647/coverage-7.9.1-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:2241ad5dbf79ae1d9c08fe52b36d03ca122fb9ac6bca0f34439e99f8327ac89f", size = 256535 },
+    { url = "https://files.pythonhosted.org/packages/81/8b/e36a04889dda9960be4263e95e777e7b46f1bb4fc32202612c130a20c4da/coverage-7.9.1-cp313-cp313t-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:3bb5838701ca68b10ebc0937dbd0eb81974bac54447c55cd58dea5bca8451029", size = 252756 },
+    { url = "https://files.pythonhosted.org/packages/98/82/be04eff8083a09a4622ecd0e1f31a2c563dbea3ed848069e7b0445043a70/coverage-7.9.1-cp313-cp313t-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b30a25f814591a8c0c5372c11ac8967f669b97444c47fd794926e175c4047ece", size = 254912 },
+    { url = "https://files.pythonhosted.org/packages/0f/25/c26610a2c7f018508a5ab958e5b3202d900422cf7cdca7670b6b8ca4e8df/coverage-7.9.1-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:2d04b16a6062516df97969f1ae7efd0de9c31eb6ebdceaa0d213b21c0ca1a683", size = 256144 },
+    { url = "https://files.pythonhosted.org/packages/c5/8b/fb9425c4684066c79e863f1e6e7ecebb49e3a64d9f7f7860ef1688c56f4a/coverage-7.9.1-cp313-cp313t-musllinux_1_2_i686.whl", hash = "sha256:7931b9e249edefb07cd6ae10c702788546341d5fe44db5b6108a25da4dca513f", size = 254257 },
+    { url = "https://files.pythonhosted.org/packages/93/df/27b882f54157fc1131e0e215b0da3b8d608d9b8ef79a045280118a8f98fe/coverage-7.9.1-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:52e92b01041151bf607ee858e5a56c62d4b70f4dac85b8c8cb7fb8a351ab2c10", size = 255094 },
+    { url = "https://files.pythonhosted.org/packages/41/5f/cad1c3dbed8b3ee9e16fa832afe365b4e3eeab1fb6edb65ebbf745eabc92/coverage-7.9.1-cp313-cp313t-win32.whl", hash = "sha256:684e2110ed84fd1ca5f40e89aa44adf1729dc85444004111aa01866507adf363", size = 215437 },
+    { url = "https://files.pythonhosted.org/packages/99/4d/fad293bf081c0e43331ca745ff63673badc20afea2104b431cdd8c278b4c/coverage-7.9.1-cp313-cp313t-win_amd64.whl", hash = "sha256:437c576979e4db840539674e68c84b3cda82bc824dd138d56bead1435f1cb5d7", size = 216605 },
+    { url = "https://files.pythonhosted.org/packages/1f/56/4ee027d5965fc7fc126d7ec1187529cc30cc7d740846e1ecb5e92d31b224/coverage-7.9.1-cp313-cp313t-win_arm64.whl", hash = "sha256:18a0912944d70aaf5f399e350445738a1a20b50fbea788f640751c2ed9208b6c", size = 214392 },
+    { url = "https://files.pythonhosted.org/packages/3e/e5/c723545c3fd3204ebde3b4cc4b927dce709d3b6dc577754bb57f63ca4a4a/coverage-7.9.1-pp39.pp310.pp311-none-any.whl", hash = "sha256:db0f04118d1db74db6c9e1cb1898532c7dcc220f1d2718f058601f7c3f499514", size = 204009 },
+    { url = "https://files.pythonhosted.org/packages/08/b8/7ddd1e8ba9701dea08ce22029917140e6f66a859427406579fd8d0ca7274/coverage-7.9.1-py3-none-any.whl", hash = "sha256:66b974b145aa189516b6bf2d8423e888b742517d37872f6ee4c5be0073bd9a3c", size = 204000 },
+]
+
+[package.optional-dependencies]
+toml = [
+    { name = "tomli", marker = "python_full_version <= '3.11'" },
+]
+
 [[package]]
 name = "cryptography"
 version = "45.0.4"
@@ -765,6 +830,15 @@ wheels = [
    { url = "https://files.pythonhosted.org/packages/50/3d/9373ad9c56321fdab5b41197068e1d8c25883b3fea29dd361f9b55116869/dill-0.4.0-py3-none-any.whl", hash = "sha256:44f54bf6412c2c8464c14e8243eb163690a9800dbe2c367330883b19c7561049", size = 119668 },
 ]

+[[package]]
+name = "distlib"
+version = "0.3.9"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/0d/dd/1bec4c5ddb504ca60fc29472f3d27e8d4da1257a854e1d96742f15c1d02d/distlib-0.3.9.tar.gz", hash = "sha256:a60f20dea646b8a33f3e7772f74dc0b2d0772d2837ee1342a00645c81edf9403", size = 613923 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/91/a1/cf2472db20f7ce4a6be1253a81cfdf85ad9c7885ffbed7047fb72c24cf87/distlib-0.3.9-py2.py3-none-any.whl", hash = "sha256:47f8c22fd27c27e25a65601af709b38e4f0a45ea4fc2e710f65755fa8caaaf87", size = 468973 },
+]
+
 [[package]]
 name = "distro"
 version = "1.9.0"
@@ -923,6 +997,20 @@ wheels = [
    { url = "https://files.pythonhosted.org/packages/18/79/1b8fa1bb3568781e84c9200f951c735f3f157429f44be0495da55894d620/filetype-1.2.0-py2.py3-none-any.whl", hash = "sha256:7ce71b6880181241cf7ac8697a2f1eb6a8bd9b429f7ad6d27b8db9ba5f1c2d25", size = 19970 },
 ]

+[[package]]
+name = "flake8"
+version = "7.3.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "mccabe" },
+    { name = "pycodestyle" },
+    { name = "pyflakes" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/9b/af/fbfe3c4b5a657d79e5c47a2827a362f9e1b763336a52f926126aa6dc7123/flake8-7.3.0.tar.gz", hash = "sha256:fe044858146b9fc69b551a4b490d69cf960fcb78ad1edcb84e7fbb1b4a8e3872", size = 48326 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/9f/56/13ab06b4f93ca7cac71078fbe37fcea175d3216f31f85c3168a6bbd0bb9a/flake8-7.3.0-py2.py3-none-any.whl", hash = "sha256:b9696257b9ce8beb888cdbe31cf885c90d31928fe202be0889a7cdafad32f01e", size = 57922 },
+]
+
 [[package]]
 name = "flatbuffers"
 version = "25.2.10"
@@ -1391,6 +1479,15 @@ wheels = [
    { url = "https://files.pythonhosted.org/packages/f0/0f/310fb31e39e2d734ccaa2c0fb981ee41f7bd5056ce9bc29b2248bd569169/humanfriendly-10.0-py2.py3-none-any.whl", hash = "sha256:1697e1a8a8f550fd43c2865cd84542fc175a61dcb779b6fee18cf6b6ccba1477", size = 86794 },
 ]

+[[package]]
+name = "identify"
+version = "2.6.12"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/a2/88/d193a27416618628a5eea64e3223acd800b40749a96ffb322a9b55a49ed1/identify-2.6.12.tar.gz", hash = "sha256:d8de45749f1efb108badef65ee8386f0f7bb19a7f26185f74de6367bffbaf0e6", size = 99254 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/7a/cd/18f8da995b658420625f7ef13f037be53ae04ec5ad33f9b718240dcfd48c/identify-2.6.12-py2.py3-none-any.whl", hash = "sha256:ad9672d5a72e0d2ff7c5c8809b62dfa60458626352fb0eb7b55e69bdc45334a2", size = 99145 },
+]
+
 [[package]]
 name = "idna"
 version = "3.10"
@@ -1412,6 +1509,15 @@ wheels = [
    { url = "https://files.pythonhosted.org/packages/20/b0/36bd937216ec521246249be3bf9855081de4c5e06a0c9b4219dbeda50373/importlib_metadata-8.7.0-py3-none-any.whl", hash = "sha256:e5dd1551894c77868a30651cef00984d50e1002d06942a7101d34870c5f02afd", size = 27656 },
 ]

+[[package]]
+name = "iniconfig"
+version = "2.1.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f2/97/ebf4da567aa6827c909642694d71c9fcf53e5b504f2d96afea02718862f3/iniconfig-2.1.0.tar.gz", hash = "sha256:3abbd2e30b36733fee78f9c7f7308f2d0050e88f0087fd25c2645f63c773e1c7", size = 4793 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/2c/e1/e6716421ea10d38022b952c159d5161ca1193197fb744506875fbb87ea7b/iniconfig-2.1.0-py3-none-any.whl", hash = "sha256:9deba5723312380e77435581c6bf4935c94cbfab9b1ed33ef8d238ea168eb760", size = 6050 },
+]
+
 [[package]]
 name = "isodate"
 version = "0.7.2"
@@ -1421,6 +1527,15 @@ wheels = [
    { url = "https://files.pythonhosted.org/packages/15/aa/0aca39a37d3c7eb941ba736ede56d689e7be91cab5d9ca846bde3999eba6/isodate-0.7.2-py3-none-any.whl", hash = "sha256:28009937d8031054830160fce6d409ed342816b543597cece116d966c6d99e15", size = 22320 },
 ]

+[[package]]
+name = "isort"
+version = "6.0.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/b8/21/1e2a441f74a653a144224d7d21afe8f4169e6c7c20bb13aec3a2dc3815e0/isort-6.0.1.tar.gz", hash = "sha256:1cb5df28dfbc742e490c5e41bad6da41b805b0a8be7bc93cd0fb2a8a890ac450", size = 821955 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c1/11/114d0a5f4dabbdcedc1125dee0888514c3c3b16d3e9facad87ed96fad97c/isort-6.0.1-py3-none-any.whl", hash = "sha256:2dc5d7f65c9678d94c88dfc29161a320eec67328bc97aad576874cb4be1e9615", size = 94186 },
+]
+
 [[package]]
 name = "jinja2"
 version = "3.1.6"
@@ -1649,6 +1764,24 @@ dependencies = [
    { name = "uvicorn", extra = ["standard"] },
 ]

+[package.optional-dependencies]
+dev = [
+    { name = "black" },
+    { name = "flake8" },
+    { name = "isort" },
+    { name = "mypy" },
+    { name = "pre-commit" },
+    { name = "pytest" },
+    { name = "pytest-asyncio" },
+    { name = "pytest-cov" },
+]
+test = [
+    { name = "httpx" },
+    { name = "pytest" },
+    { name = "pytest-asyncio" },
+    { name = "pytest-cov" },
+]
+
 [package.metadata]
 requires-dist = [
    { name = "aiofiles", specifier = ">=23.2.1" },
@@ -1657,11 +1790,15 @@ requires-dist = [
    { name = "alembic", specifier = ">=1.13.0" },
    { name = "anthropic", specifier = ">=0.7.0" },
    { name = "beautifulsoup4", specifier = ">=4.12.0" },
+    { name = "black", marker = "extra == 'dev'", specifier = ">=23.0.0" },
    { name = "chardet", specifier = ">=5.0.0" },
    { name = "click", specifier = ">=8.0.0" },
    { name = "fastapi", specifier = ">=0.104.0" },
+    { name = "flake8", marker = "extra == 'dev'", specifier = ">=6.0.0" },
    { name = "google-generativeai", specifier = ">=0.3.0" },
    { name = "httpx", specifier = ">=0.25.0" },
+    { name = "httpx", marker = "extra == 'test'", specifier = ">=0.25.0" },
+    { name = "isort", marker = "extra == 'dev'", specifier = ">=5.12.0" },
    { name = "jinja2", specifier = ">=3.1.2" },
    { name = "langchain", specifier = ">=0.1.0" },
    { name = "langchain-anthropic", specifier = ">=0.1.0" },
@@ -1673,16 +1810,24 @@ requires-dist = [
    { name = "markdown", specifier = ">=3.5.1" },
    { name = "markitdown", extras = ["all"], specifier = ">=0.1.2" },
    { name = "mineru", extras = ["core"], specifier = ">=2.0.6" },
+    { name = "mypy", marker = "extra == 'dev'", specifier = ">=1.0.0" },
    { name = "ollama", specifier = ">=0.1.0" },
    { name = "onnxruntime", specifier = "==1.19.2" },
    { name = "openai", specifier = ">=1.0.0" },
    { name = "pandas", specifier = ">=2.0.0" },
    { name = "passlib", extras = ["bcrypt"], specifier = ">=1.7.4" },
    { name = "pdfkit", specifier = ">=1.0.0" },
+    { name = "pre-commit", marker = "extra == 'dev'", specifier = ">=3.0.0" },
    { name = "pydantic", specifier = ">=2.5.0" },
    { name = "pydantic-settings", specifier = ">=2.0.0" },
    { name = "pypdf2", specifier = ">=3.0.1" },
    { name = "pyppeteer", specifier = ">=1.0.2" },
+    { name = "pytest", marker = "extra == 'dev'", specifier = ">=7.0.0" },
+    { name = "pytest", marker = "extra == 'test'", specifier = ">=7.0.0" },
+    { name = "pytest-asyncio", marker = "extra == 'dev'", specifier = ">=0.21.0" },
+    { name = "pytest-asyncio", marker = "extra == 'test'", specifier = ">=0.21.0" },
+    { name = "pytest-cov", marker = "extra == 'dev'", specifier = ">=4.0.0" },
+    { name = "pytest-cov", marker = "extra == 'test'", specifier = ">=4.0.0" },
    { name = "python-docx", specifier = ">=1.1.0" },
    { name = "python-dotenv", specifier = ">=1.0.0" },
    { name = "python-jose", extras = ["cryptography"], specifier = ">=3.3.0" },
@@ -2148,6 +2293,15 @@ wheels = [
    { url = "https://files.pythonhosted.org/packages/1b/92/9a45c91089c3cf690b5badd4be81e392ff086ccca8a1d4e3a08463d8a966/matplotlib-3.10.3-cp313-cp313t-win_amd64.whl", hash = "sha256:4f23ffe95c5667ef8a2b56eea9b53db7f43910fa4a2d5472ae0f72b64deab4d5", size = 8139044 },
 ]

+[[package]]
+name = "mccabe"
+version = "0.7.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/e7/ff/0ffefdcac38932a54d2b5eed4e0ba8a408f215002cd178ad1df0f2806ff8/mccabe-0.7.0.tar.gz", hash = "sha256:348e0240c33b60bbdf4e523192ef919f28cb2c3d7d5c7794f74009290f236325", size = 9658 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/27/1a/1f68f9ba0c207934b35b86a8ca3aad8395a3d6dd7921c0686e23853ff5a9/mccabe-0.7.0-py2.py3-none-any.whl", hash = "sha256:6c2d30ab6be0e4a46919781807b4f0d834ebdd6c6e3dca0bda5a15f863427b6e", size = 7350 },
+]
+
 [[package]]
 name = "mdurl"
 version = "0.1.2"
@@ -2327,6 +2481,47 @@ wheels = [
    { url = "https://files.pythonhosted.org/packages/07/9f/d4719ce55a1d8bf6619e8bb92f1e2e7399026ea85ae0c324ec77ee06c050/multidict-6.5.1-py3-none-any.whl", hash = "sha256:895354f4a38f53a1df2cc3fa2223fa714cff2b079a9f018a76cad35e7f0f044c", size = 12185 },
 ]

+[[package]]
+name = "mypy"
+version = "1.16.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "mypy-extensions" },
+    { name = "pathspec" },
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/81/69/92c7fa98112e4d9eb075a239caa4ef4649ad7d441545ccffbd5e34607cbb/mypy-1.16.1.tar.gz", hash = "sha256:6bd00a0a2094841c5e47e7374bb42b83d64c527a502e3334e1173a0c24437bab", size = 3324747 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/9a/61/ec1245aa1c325cb7a6c0f8570a2eee3bfc40fa90d19b1267f8e50b5c8645/mypy-1.16.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:472e4e4c100062488ec643f6162dd0d5208e33e2f34544e1fc931372e806c0cc", size = 10890557 },
+    { url = "https://files.pythonhosted.org/packages/6b/bb/6eccc0ba0aa0c7a87df24e73f0ad34170514abd8162eb0c75fd7128171fb/mypy-1.16.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:ea16e2a7d2714277e349e24d19a782a663a34ed60864006e8585db08f8ad1782", size = 10012921 },
+    { url = "https://files.pythonhosted.org/packages/5f/80/b337a12e2006715f99f529e732c5f6a8c143bb58c92bb142d5ab380963a5/mypy-1.16.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:08e850ea22adc4d8a4014651575567b0318ede51e8e9fe7a68f25391af699507", size = 11802887 },
+    { url = "https://files.pythonhosted.org/packages/d9/59/f7af072d09793d581a745a25737c7c0a945760036b16aeb620f658a017af/mypy-1.16.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:22d76a63a42619bfb90122889b903519149879ddbf2ba4251834727944c8baca", size = 12531658 },
+    { url = "https://files.pythonhosted.org/packages/82/c4/607672f2d6c0254b94a646cfc45ad589dd71b04aa1f3d642b840f7cce06c/mypy-1.16.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:2c7ce0662b6b9dc8f4ed86eb7a5d505ee3298c04b40ec13b30e572c0e5ae17c4", size = 12732486 },
+    { url = "https://files.pythonhosted.org/packages/b6/5e/136555ec1d80df877a707cebf9081bd3a9f397dedc1ab9750518d87489ec/mypy-1.16.1-cp311-cp311-win_amd64.whl", hash = "sha256:211287e98e05352a2e1d4e8759c5490925a7c784ddc84207f4714822f8cf99b6", size = 9479482 },
+    { url = "https://files.pythonhosted.org/packages/b4/d6/39482e5fcc724c15bf6280ff5806548c7185e0c090712a3736ed4d07e8b7/mypy-1.16.1-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:af4792433f09575d9eeca5c63d7d90ca4aeceda9d8355e136f80f8967639183d", size = 11066493 },
+    { url = "https://files.pythonhosted.org/packages/e6/e5/26c347890efc6b757f4d5bb83f4a0cf5958b8cf49c938ac99b8b72b420a6/mypy-1.16.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:66df38405fd8466ce3517eda1f6640611a0b8e70895e2a9462d1d4323c5eb4b9", size = 10081687 },
+    { url = "https://files.pythonhosted.org/packages/44/c7/b5cb264c97b86914487d6a24bd8688c0172e37ec0f43e93b9691cae9468b/mypy-1.16.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:44e7acddb3c48bd2713994d098729494117803616e116032af192871aed80b79", size = 11839723 },
+    { url = "https://files.pythonhosted.org/packages/15/f8/491997a9b8a554204f834ed4816bda813aefda31cf873bb099deee3c9a99/mypy-1.16.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0ab5eca37b50188163fa7c1b73c685ac66c4e9bdee4a85c9adac0e91d8895e15", size = 12722980 },
+    { url = "https://files.pythonhosted.org/packages/df/f0/2bd41e174b5fd93bc9de9a28e4fb673113633b8a7f3a607fa4a73595e468/mypy-1.16.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:dedb6229b2c9086247e21a83c309754b9058b438704ad2f6807f0d8227f6ebdd", size = 12903328 },
+    { url = "https://files.pythonhosted.org/packages/61/81/5572108a7bec2c46b8aff7e9b524f371fe6ab5efb534d38d6b37b5490da8/mypy-1.16.1-cp312-cp312-win_amd64.whl", hash = "sha256:1f0435cf920e287ff68af3d10a118a73f212deb2ce087619eb4e648116d1fe9b", size = 9562321 },
+    { url = "https://files.pythonhosted.org/packages/28/e3/96964af4a75a949e67df4b95318fe2b7427ac8189bbc3ef28f92a1c5bc56/mypy-1.16.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:ddc91eb318c8751c69ddb200a5937f1232ee8efb4e64e9f4bc475a33719de438", size = 11063480 },
+    { url = "https://files.pythonhosted.org/packages/f5/4d/cd1a42b8e5be278fab7010fb289d9307a63e07153f0ae1510a3d7b703193/mypy-1.16.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:87ff2c13d58bdc4bbe7dc0dedfe622c0f04e2cb2a492269f3b418df2de05c536", size = 10090538 },
+    { url = "https://files.pythonhosted.org/packages/c9/4f/c3c6b4b66374b5f68bab07c8cabd63a049ff69796b844bc759a0ca99bb2a/mypy-1.16.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:0a7cfb0fe29fe5a9841b7c8ee6dffb52382c45acdf68f032145b75620acfbd6f", size = 11836839 },
+    { url = "https://files.pythonhosted.org/packages/b4/7e/81ca3b074021ad9775e5cb97ebe0089c0f13684b066a750b7dc208438403/mypy-1.16.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:051e1677689c9d9578b9c7f4d206d763f9bbd95723cd1416fad50db49d52f359", size = 12715634 },
+    { url = "https://files.pythonhosted.org/packages/e9/95/bdd40c8be346fa4c70edb4081d727a54d0a05382d84966869738cfa8a497/mypy-1.16.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:d5d2309511cc56c021b4b4e462907c2b12f669b2dbeb68300110ec27723971be", size = 12895584 },
+    { url = "https://files.pythonhosted.org/packages/5a/fd/d486a0827a1c597b3b48b1bdef47228a6e9ee8102ab8c28f944cb83b65dc/mypy-1.16.1-cp313-cp313-win_amd64.whl", hash = "sha256:4f58ac32771341e38a853c5d0ec0dfe27e18e27da9cdb8bbc882d2249c71a3ee", size = 9573886 },
+    { url = "https://files.pythonhosted.org/packages/cf/d3/53e684e78e07c1a2bf7105715e5edd09ce951fc3f47cf9ed095ec1b7a037/mypy-1.16.1-py3-none-any.whl", hash = "sha256:5fc2ac4027d0ef28d6ba69a0343737a23c4d1b83672bf38d1fe237bdc0643b37", size = 2265923 },
+]
+
+[[package]]
+name = "mypy-extensions"
+version = "1.1.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/a2/6e/371856a3fb9d31ca8dac321cda606860fa4548858c0cc45d9d1d4ca2628b/mypy_extensions-1.1.0.tar.gz", hash = "sha256:52e68efc3284861e772bbcd66823fde5ae21fd2fdb51c62a211403730b916558", size = 6343 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/79/7b/2c79738432f5c924bef5071f933bcc9efd0473bac3b4aa584a6f7c1c8df8/mypy_extensions-1.1.0-py3-none-any.whl", hash = "sha256:1be4cccdb0f2482337c4743e60421de3a356cd97508abadd57d47403e94f5505", size = 4963 },
+]
+
 [[package]]
 name = "networkx"
 version = "3.5"
@@ -2336,6 +2531,15 @@ wheels = [
    { url = "https://files.pythonhosted.org/packages/eb/8d/776adee7bbf76365fdd7f2552710282c79a4ead5d2a46408c9043a2b70ba/networkx-3.5-py3-none-any.whl", hash = "sha256:0030d386a9a06dee3565298b4a734b68589749a544acbb6c412dc9e2489ec6ec", size = 2034406 },
 ]

+[[package]]
+name = "nodeenv"
+version = "1.9.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/43/16/fc88b08840de0e0a72a2f9d8c6bae36be573e475a6326ae854bcc549fc45/nodeenv-1.9.1.tar.gz", hash = "sha256:6ec12890a2dab7946721edbfbcd91f3319c6ccc9aec47be7c7e6b7011ee6645f", size = 47437 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d2/1d/1b658dbd2b9fa9c4c9f32accbfc0205d532c8c6194dc0f2a4c0428e7128a/nodeenv-1.9.1-py2.py3-none-any.whl", hash = "sha256:ba11c9782d29c27c70ffbdda2d7415098754709be8a7056d79a737cd901155c9", size = 22314 },
+]
+
 [[package]]
 name = "numpy"
 version = "2.3.1"
@@ -2439,7 +2643,7 @@ name = "nvidia-cudnn-cu12"
 version = "9.5.1.17"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "nvidia-cublas-cu12", marker = "(platform_machine != 'aarch64' and platform_system != 'Darwin') or (platform_system != 'Darwin' and platform_system != 'Linux' and sys_platform != 'linux')" },
+    { name = "nvidia-cublas-cu12", marker = "(platform_machine != 'aarch64' and sys_platform == 'linux') or (sys_platform != 'darwin' and sys_platform != 'linux' and sys_platform != 'win32')" },
 ]
 wheels = [
    { url = "https://files.pythonhosted.org/packages/99/93/a201a12d3ec1caa8c6ac34c1c2f9eeb696b886f0c36ff23c638b46603bd0/nvidia_cudnn_cu12-9.5.1.17-py3-none-manylinux_2_28_aarch64.whl", hash = "sha256:9fd4584468533c61873e5fda8ca41bac3a38bcb2d12350830c69b0a96a7e4def", size = 570523509 },
@@ -2451,7 +2655,7 @@ name = "nvidia-cufft-cu12"
 version = "11.3.0.4"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "nvidia-nvjitlink-cu12", marker = "(platform_machine != 'aarch64' and platform_system != 'Darwin') or (platform_system != 'Darwin' and platform_system != 'Linux' and sys_platform != 'linux')" },
+    { name = "nvidia-nvjitlink-cu12", marker = "(platform_machine != 'aarch64' and sys_platform == 'linux') or (sys_platform != 'darwin' and sys_platform != 'linux' and sys_platform != 'win32')" },
 ]
 wheels = [
    { url = "https://files.pythonhosted.org/packages/1f/37/c50d2b2f2c07e146776389e3080f4faf70bcc4fa6e19d65bb54ca174ebc3/nvidia_cufft_cu12-11.3.0.4-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:d16079550df460376455cba121db6564089176d9bac9e4f360493ca4741b22a6", size = 200164144 },
@@ -2485,9 +2689,9 @@ name = "nvidia-cusolver-cu12"
 version = "11.7.1.2"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "nvidia-cublas-cu12", marker = "(platform_machine != 'aarch64' and platform_system != 'Darwin') or (platform_system != 'Darwin' and platform_system != 'Linux' and sys_platform != 'linux')" },
-    { name = "nvidia-cusparse-cu12", marker = "(platform_machine != 'aarch64' and platform_system != 'Darwin') or (platform_system != 'Darwin' and platform_system != 'Linux' and sys_platform != 'linux')" },
-    { name = "nvidia-nvjitlink-cu12", marker = "(platform_machine != 'aarch64' and platform_system != 'Darwin') or (platform_system != 'Darwin' and platform_system != 'Linux' and sys_platform != 'linux')" },
+    { name = "nvidia-cublas-cu12", marker = "(platform_machine != 'aarch64' and sys_platform == 'linux') or (sys_platform != 'darwin' and sys_platform != 'linux' and sys_platform != 'win32')" },
+    { name = "nvidia-cusparse-cu12", marker = "(platform_machine != 'aarch64' and sys_platform == 'linux') or (sys_platform != 'darwin' and sys_platform != 'linux' and sys_platform != 'win32')" },
+    { name = "nvidia-nvjitlink-cu12", marker = "(platform_machine != 'aarch64' and sys_platform == 'linux') or (sys_platform != 'darwin' and sys_platform != 'linux' and sys_platform != 'win32')" },
 ]
 wheels = [
    { url = "https://files.pythonhosted.org/packages/93/17/dbe1aa865e4fdc7b6d4d0dd308fdd5aaab60f939abfc0ea1954eac4fb113/nvidia_cusolver_cu12-11.7.1.2-py3-none-manylinux2014_aarch64.whl", hash = "sha256:0ce237ef60acde1efc457335a2ddadfd7610b892d94efee7b776c64bb1cac9e0", size = 157833628 },
@@ -2501,7 +2705,7 @@ name = "nvidia-cusparse-cu12"
 version = "12.5.4.2"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "nvidia-nvjitlink-cu12", marker = "(platform_machine != 'aarch64' and platform_system != 'Darwin') or (platform_system != 'Darwin' and platform_system != 'Linux' and sys_platform != 'linux')" },
+    { name = "nvidia-nvjitlink-cu12", marker = "(platform_machine != 'aarch64' and sys_platform == 'linux') or (sys_platform != 'darwin' and sys_platform != 'linux' and sys_platform != 'win32')" },
 ]
 wheels = [
    { url = "https://files.pythonhosted.org/packages/eb/eb/6681efd0aa7df96b4f8067b3ce7246833dd36830bb4cec8896182773db7d/nvidia_cusparse_cu12-12.5.4.2-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:d25b62fb18751758fe3c93a4a08eff08effedfe4edf1c6bb5afd0890fe88f887", size = 216451147 },
@@ -2822,6 +3026,15 @@ bcrypt = [
    { name = "bcrypt" },
 ]

+[[package]]
+name = "pathspec"
+version = "0.12.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/ca/bc/f35b8446f4531a7cb215605d100cd88b7ac6f44ab3fc94870c120ab3adbf/pathspec-0.12.1.tar.gz", hash = "sha256:a482d51503a1ab33b1c67a6c3813a26953dbdc71c31dacaef9a838c4e29f5712", size = 51043 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/cc/20/ff623b09d963f88bfde16306a54e12ee5ea43e9b597108672ff3a408aad6/pathspec-0.12.1-py3-none-any.whl", hash = "sha256:a0d503e138a4c123b27490a4f7beda6a01c6f288df0e4a8b79c7eb0dc7b4cc08", size = 31191 },
+]
+
 [[package]]
 name = "pdfkit"
 version = "1.0.0"
@@ -2918,6 +3131,40 @@ wheels = [
    { url = "https://files.pythonhosted.org/packages/21/2c/5e05f58658cf49b6667762cca03d6e7d85cededde2caf2ab37b81f80e574/pillow-11.2.1-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:208653868d5c9ecc2b327f9b9ef34e0e42a4cdd172c2988fd81d62d2bc9bc044", size = 2674751 },
 ]

+[[package]]
+name = "platformdirs"
+version = "4.3.8"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/fe/8b/3c73abc9c759ecd3f1f7ceff6685840859e8070c4d947c93fae71f6a0bf2/platformdirs-4.3.8.tar.gz", hash = "sha256:3d512d96e16bcb959a814c9f348431070822a6496326a4be0911c40b5a74c2bc", size = 21362 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/fe/39/979e8e21520d4e47a0bbe349e2713c0aac6f3d853d0e5b34d76206c439aa/platformdirs-4.3.8-py3-none-any.whl", hash = "sha256:ff7059bb7eb1179e2685604f4aaf157cfd9535242bd23742eadc3c13542139b4", size = 18567 },
+]
+
+[[package]]
+name = "pluggy"
+version = "1.6.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f9/e2/3e91f31a7d2b083fe6ef3fa267035b518369d9511ffab804f839851d2779/pluggy-1.6.0.tar.gz", hash = "sha256:7dcc130b76258d33b90f61b658791dede3486c3e6bfb003ee5c9bfb396dd22f3", size = 69412 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746", size = 20538 },
+]
+
+[[package]]
+name = "pre-commit"
+version = "4.2.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "cfgv" },
+    { name = "identify" },
+    { name = "nodeenv" },
+    { name = "pyyaml" },
+    { name = "virtualenv" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/08/39/679ca9b26c7bb2999ff122d50faa301e49af82ca9c066ec061cfbc0c6784/pre_commit-4.2.0.tar.gz", hash = "sha256:601283b9757afd87d40c4c4a9b2b5de9637a8ea02eaff7adc2d0fb4e04841146", size = 193424 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/88/74/a88bf1b1efeae488a0c0b7bdf71429c313722d1fc0f377537fbe554e6180/pre_commit-4.2.0-py2.py3-none-any.whl", hash = "sha256:a009ca7205f1eb497d10b845e52c838a98b6cdd2102a6c8e4540e94ee75c58bd", size = 220707 },
+]
+
 [[package]]
 name = "propcache"
 version = "0.3.2"
@@ -3088,6 +3335,15 @@ wheels = [
    { url = "https://files.pythonhosted.org/packages/d5/19/9ff4551b42f2068686c50c0d199072fa67aee57fc5cf86770cacf71efda3/pyclipper-1.3.0.post6-cp313-cp313-win_amd64.whl", hash = "sha256:e5ff68fa770ac654c7974fc78792978796f068bd274e95930c0691c31e192889", size = 109672 },
 ]

+[[package]]
+name = "pycodestyle"
+version = "2.14.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/11/e0/abfd2a0d2efe47670df87f3e3a0e2edda42f055053c85361f19c0e2c1ca8/pycodestyle-2.14.0.tar.gz", hash = "sha256:c4b5b517d278089ff9d0abdec919cd97262a3367449ea1c8b49b91529167b783", size = 39472 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d7/27/a58ddaf8c588a3ef080db9d0b7e0b97215cee3a45df74f3a94dbbf5c893a/pycodestyle-2.14.0-py2.py3-none-any.whl", hash = "sha256:dd6bf7cb4ee77f8e016f9c8e74a35ddd9f67e1d5fd4184d86c3b98e07099f42d", size = 31594 },
+]
+
 [[package]]
 name = "pycparser"
 version = "2.22"
@@ -3212,6 +3468,15 @@ wheels = [
    { url = "https://files.pythonhosted.org/packages/db/99/7e80837f60b13227f03334e3b0537d650dea2c0cea44c543b0a2e719a48f/pyee-11.1.1-py3-none-any.whl", hash = "sha256:9e4cdd7c2f9fcf247db94bad39a260aceffefdbe52286ce71be01959de34a5c2", size = 15300 },
 ]

+[[package]]
+name = "pyflakes"
+version = "3.4.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/45/dc/fd034dc20b4b264b3d015808458391acbf9df40b1e54750ef175d39180b1/pyflakes-3.4.0.tar.gz", hash = "sha256:b24f96fafb7d2ab0ec5075b7350b3d2d2218eab42003821c06344973d3ea2f58", size = 64669 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c2/2f/81d580a0fb83baeb066698975cb14a618bdbed7720678566f1b046a95fe8/pyflakes-3.4.0-py2.py3-none-any.whl", hash = "sha256:f742a7dbd0d9cb9ea41e9a24a918996e8170c799fa528688d40dd582c8265f4f", size = 63551 },
+]
+
 [[package]]
 name = "pygments"
 version = "2.19.2"
@@ -3309,6 +3574,48 @@ wheels = [
    { url = "https://files.pythonhosted.org/packages/5a/dc/491b7661614ab97483abf2056be1deee4dc2490ecbf7bff9ab5cdbac86e1/pyreadline3-3.5.4-py3-none-any.whl", hash = "sha256:eaf8e6cc3c49bcccf145fc6067ba8643d1df34d604a1ec0eccbf7a18e6d3fae6", size = 83178 },
 ]

+[[package]]
+name = "pytest"
+version = "8.4.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "iniconfig" },
+    { name = "packaging" },
+    { name = "pluggy" },
+    { name = "pygments" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/08/ba/45911d754e8eba3d5a841a5ce61a65a685ff1798421ac054f85aa8747dfb/pytest-8.4.1.tar.gz", hash = "sha256:7c67fd69174877359ed9371ec3af8a3d2b04741818c51e5e99cc1742251fa93c", size = 1517714 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/29/16/c8a903f4c4dffe7a12843191437d7cd8e32751d5de349d45d3fe69544e87/pytest-8.4.1-py3-none-any.whl", hash = "sha256:539c70ba6fcead8e78eebbf1115e8b589e7565830d7d006a8723f19ac8a0afb7", size = 365474 },
+]
+
+[[package]]
+name = "pytest-asyncio"
+version = "1.0.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "pytest" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/d0/d4/14f53324cb1a6381bef29d698987625d80052bb33932d8e7cbf9b337b17c/pytest_asyncio-1.0.0.tar.gz", hash = "sha256:d15463d13f4456e1ead2594520216b225a16f781e144f8fdf6c5bb4667c48b3f", size = 46960 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/30/05/ce271016e351fddc8399e546f6e23761967ee09c8c568bbfbecb0c150171/pytest_asyncio-1.0.0-py3-none-any.whl", hash = "sha256:4f024da9f1ef945e680dc68610b52550e36590a67fd31bb3b4943979a1f90ef3", size = 15976 },
+]
+
+[[package]]
+name = "pytest-cov"
+version = "6.2.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "coverage", extra = ["toml"] },
+    { name = "pluggy" },
+    { name = "pytest" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/18/99/668cade231f434aaa59bbfbf49469068d2ddd945000621d3d165d2e7dd7b/pytest_cov-6.2.1.tar.gz", hash = "sha256:25cc6cc0a5358204b8108ecedc51a9b57b34cc6b8c967cc2c01a4e00d8a67da2", size = 69432 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/bc/16/4ea354101abb1287856baa4af2732be351c7bee728065aed451b678153fd/pytest_cov-6.2.1-py3-none-any.whl", hash = "sha256:f5bc4c23f42f1cdd23c70b1dab1bbaef4fc505ba950d53e0081d0730dd7e86d5", size = 24644 },
+]
+
 [[package]]
 name = "python-dateutil"
 version = "2.9.0.post0"
@@ -4047,6 +4354,45 @@ wheels = [
    { url = "https://files.pythonhosted.org/packages/13/c3/cc2755ee10be859c4338c962a35b9a663788c0c0b50c0bdd8078fb6870cf/tokenizers-0.21.2-cp39-abi3-win_amd64.whl", hash = "sha256:58747bb898acdb1007f37a7bbe614346e98dc28708ffb66a3fd50ce169ac6c98", size = 2509918 },
 ]

+[[package]]
+name = "tomli"
+version = "2.2.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/18/87/302344fed471e44a87289cf4967697d07e532f2421fdaf868a303cbae4ff/tomli-2.2.1.tar.gz", hash = "sha256:cd45e1dc79c835ce60f7404ec8119f2eb06d38b1deba146f07ced3bbc44505ff", size = 17175 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/43/ca/75707e6efa2b37c77dadb324ae7d9571cb424e61ea73fad7c56c2d14527f/tomli-2.2.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:678e4fa69e4575eb77d103de3df8a895e1591b48e740211bd1067378c69e8249", size = 131077 },
+    { url = "https://files.pythonhosted.org/packages/c7/16/51ae563a8615d472fdbffc43a3f3d46588c264ac4f024f63f01283becfbb/tomli-2.2.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:023aa114dd824ade0100497eb2318602af309e5a55595f76b626d6d9f3b7b0a6", size = 123429 },
+    { url = "https://files.pythonhosted.org/packages/f1/dd/4f6cd1e7b160041db83c694abc78e100473c15d54620083dbd5aae7b990e/tomli-2.2.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ece47d672db52ac607a3d9599a9d48dcb2f2f735c6c2d1f34130085bb12b112a", size = 226067 },
+    { url = "https://files.pythonhosted.org/packages/a9/6b/c54ede5dc70d648cc6361eaf429304b02f2871a345bbdd51e993d6cdf550/tomli-2.2.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:6972ca9c9cc9f0acaa56a8ca1ff51e7af152a9f87fb64623e31d5c83700080ee", size = 236030 },
+    { url = "https://files.pythonhosted.org/packages/1f/47/999514fa49cfaf7a92c805a86c3c43f4215621855d151b61c602abb38091/tomli-2.2.1-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:c954d2250168d28797dd4e3ac5cf812a406cd5a92674ee4c8f123c889786aa8e", size = 240898 },
+    { url = "https://files.pythonhosted.org/packages/73/41/0a01279a7ae09ee1573b423318e7934674ce06eb33f50936655071d81a24/tomli-2.2.1-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:8dd28b3e155b80f4d54beb40a441d366adcfe740969820caf156c019fb5c7ec4", size = 229894 },
+    { url = "https://files.pythonhosted.org/packages/55/18/5d8bc5b0a0362311ce4d18830a5d28943667599a60d20118074ea1b01bb7/tomli-2.2.1-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:e59e304978767a54663af13c07b3d1af22ddee3bb2fb0618ca1593e4f593a106", size = 245319 },
+    { url = "https://files.pythonhosted.org/packages/92/a3/7ade0576d17f3cdf5ff44d61390d4b3febb8a9fc2b480c75c47ea048c646/tomli-2.2.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:33580bccab0338d00994d7f16f4c4ec25b776af3ffaac1ed74e0b3fc95e885a8", size = 238273 },
+    { url = "https://files.pythonhosted.org/packages/72/6f/fa64ef058ac1446a1e51110c375339b3ec6be245af9d14c87c4a6412dd32/tomli-2.2.1-cp311-cp311-win32.whl", hash = "sha256:465af0e0875402f1d226519c9904f37254b3045fc5084697cefb9bdde1ff99ff", size = 98310 },
+    { url = "https://files.pythonhosted.org/packages/6a/1c/4a2dcde4a51b81be3530565e92eda625d94dafb46dbeb15069df4caffc34/tomli-2.2.1-cp311-cp311-win_amd64.whl", hash = "sha256:2d0f2fdd22b02c6d81637a3c95f8cd77f995846af7414c5c4b8d0545afa1bc4b", size = 108309 },
+    { url = "https://files.pythonhosted.org/packages/52/e1/f8af4c2fcde17500422858155aeb0d7e93477a0d59a98e56cbfe75070fd0/tomli-2.2.1-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:4a8f6e44de52d5e6c657c9fe83b562f5f4256d8ebbfe4ff922c495620a7f6cea", size = 132762 },
+    { url = "https://files.pythonhosted.org/packages/03/b8/152c68bb84fc00396b83e7bbddd5ec0bd3dd409db4195e2a9b3e398ad2e3/tomli-2.2.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:8d57ca8095a641b8237d5b079147646153d22552f1c637fd3ba7f4b0b29167a8", size = 123453 },
+    { url = "https://files.pythonhosted.org/packages/c8/d6/fc9267af9166f79ac528ff7e8c55c8181ded34eb4b0e93daa767b8841573/tomli-2.2.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:4e340144ad7ae1533cb897d406382b4b6fede8890a03738ff1683af800d54192", size = 233486 },
+    { url = "https://files.pythonhosted.org/packages/5c/51/51c3f2884d7bab89af25f678447ea7d297b53b5a3b5730a7cb2ef6069f07/tomli-2.2.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:db2b95f9de79181805df90bedc5a5ab4c165e6ec3fe99f970d0e302f384ad222", size = 242349 },
+    { url = "https://files.pythonhosted.org/packages/ab/df/bfa89627d13a5cc22402e441e8a931ef2108403db390ff3345c05253935e/tomli-2.2.1-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:40741994320b232529c802f8bc86da4e1aa9f413db394617b9a256ae0f9a7f77", size = 252159 },
+    { url = "https://files.pythonhosted.org/packages/9e/6e/fa2b916dced65763a5168c6ccb91066f7639bdc88b48adda990db10c8c0b/tomli-2.2.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:400e720fe168c0f8521520190686ef8ef033fb19fc493da09779e592861b78c6", size = 237243 },
+    { url = "https://files.pythonhosted.org/packages/b4/04/885d3b1f650e1153cbb93a6a9782c58a972b94ea4483ae4ac5cedd5e4a09/tomli-2.2.1-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:02abe224de6ae62c19f090f68da4e27b10af2b93213d36cf44e6e1c5abd19fdd", size = 259645 },
+    { url = "https://files.pythonhosted.org/packages/9c/de/6b432d66e986e501586da298e28ebeefd3edc2c780f3ad73d22566034239/tomli-2.2.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:b82ebccc8c8a36f2094e969560a1b836758481f3dc360ce9a3277c65f374285e", size = 244584 },
+    { url = "https://files.pythonhosted.org/packages/1c/9a/47c0449b98e6e7d1be6cbac02f93dd79003234ddc4aaab6ba07a9a7482e2/tomli-2.2.1-cp312-cp312-win32.whl", hash = "sha256:889f80ef92701b9dbb224e49ec87c645ce5df3fa2cc548664eb8a25e03127a98", size = 98875 },
+    { url = "https://files.pythonhosted.org/packages/ef/60/9b9638f081c6f1261e2688bd487625cd1e660d0a85bd469e91d8db969734/tomli-2.2.1-cp312-cp312-win_amd64.whl", hash = "sha256:7fc04e92e1d624a4a63c76474610238576942d6b8950a2d7f908a340494e67e4", size = 109418 },
+    { url = "https://files.pythonhosted.org/packages/04/90/2ee5f2e0362cb8a0b6499dc44f4d7d48f8fff06d28ba46e6f1eaa61a1388/tomli-2.2.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:f4039b9cbc3048b2416cc57ab3bda989a6fcf9b36cf8937f01a6e731b64f80d7", size = 132708 },
+    { url = "https://files.pythonhosted.org/packages/c0/ec/46b4108816de6b385141f082ba99e315501ccd0a2ea23db4a100dd3990ea/tomli-2.2.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:286f0ca2ffeeb5b9bd4fcc8d6c330534323ec51b2f52da063b11c502da16f30c", size = 123582 },
+    { url = "https://files.pythonhosted.org/packages/a0/bd/b470466d0137b37b68d24556c38a0cc819e8febe392d5b199dcd7f578365/tomli-2.2.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a92ef1a44547e894e2a17d24e7557a5e85a9e1d0048b0b5e7541f76c5032cb13", size = 232543 },
+    { url = "https://files.pythonhosted.org/packages/d9/e5/82e80ff3b751373f7cead2815bcbe2d51c895b3c990686741a8e56ec42ab/tomli-2.2.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9316dc65bed1684c9a98ee68759ceaed29d229e985297003e494aa825ebb0281", size = 241691 },
+    { url = "https://files.pythonhosted.org/packages/05/7e/2a110bc2713557d6a1bfb06af23dd01e7dde52b6ee7dadc589868f9abfac/tomli-2.2.1-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:e85e99945e688e32d5a35c1ff38ed0b3f41f43fad8df0bdf79f72b2ba7bc5272", size = 251170 },
+    { url = "https://files.pythonhosted.org/packages/64/7b/22d713946efe00e0adbcdfd6d1aa119ae03fd0b60ebed51ebb3fa9f5a2e5/tomli-2.2.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:ac065718db92ca818f8d6141b5f66369833d4a80a9d74435a268c52bdfa73140", size = 236530 },
+    { url = "https://files.pythonhosted.org/packages/38/31/3a76f67da4b0cf37b742ca76beaf819dca0ebef26d78fc794a576e08accf/tomli-2.2.1-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:d920f33822747519673ee656a4b6ac33e382eca9d331c87770faa3eef562aeb2", size = 258666 },
+    { url = "https://files.pythonhosted.org/packages/07/10/5af1293da642aded87e8a988753945d0cf7e00a9452d3911dd3bb354c9e2/tomli-2.2.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:a198f10c4d1b1375d7687bc25294306e551bf1abfa4eace6650070a5c1ae2744", size = 243954 },
+    { url = "https://files.pythonhosted.org/packages/5b/b9/1ed31d167be802da0fc95020d04cd27b7d7065cc6fbefdd2f9186f60d7bd/tomli-2.2.1-cp313-cp313-win32.whl", hash = "sha256:d3f5614314d758649ab2ab3a62d4f2004c825922f9e370b29416484086b264ec", size = 98724 },
+    { url = "https://files.pythonhosted.org/packages/c7/32/b0963458706accd9afcfeb867c0f9175a741bf7b19cd424230714d722198/tomli-2.2.1-cp313-cp313-win_amd64.whl", hash = "sha256:a38aa0308e754b0e3c67e344754dff64999ff9b513e691d0e786265c93583c69", size = 109383 },
+    { url = "https://files.pythonhosted.org/packages/6e/c2/61d3e0f47e2b74ef40a68b9e6ad5984f6241a942f7cd3bbfbdbd03861ea9/tomli-2.2.1-py3-none-any.whl", hash = "sha256:cb55c73c5f4408779d0cf3eef9f762b9c9f147a77de7b258bef0a5628adc85cc", size = 14257 },
+]
+
 [[package]]
 name = "torch"
 version = "2.7.1"
@@ -4056,23 +4402,23 @@ dependencies = [
    { name = "fsspec" },
    { name = "jinja2" },
    { name = "networkx" },
-    { name = "nvidia-cublas-cu12", marker = "platform_machine == 'x86_64' and platform_system == 'Linux'" },
-    { name = "nvidia-cuda-cupti-cu12", marker = "platform_machine == 'x86_64' and platform_system == 'Linux'" },
-    { name = "nvidia-cuda-nvrtc-cu12", marker = "platform_machine == 'x86_64' and platform_system == 'Linux'" },
-    { name = "nvidia-cuda-runtime-cu12", marker = "platform_machine == 'x86_64' and platform_system == 'Linux'" },
-    { name = "nvidia-cudnn-cu12", marker = "platform_machine == 'x86_64' and platform_system == 'Linux'" },
-    { name = "nvidia-cufft-cu12", marker = "platform_machine == 'x86_64' and platform_system == 'Linux'" },
-    { name = "nvidia-cufile-cu12", marker = "platform_machine == 'x86_64' and platform_system == 'Linux'" },
-    { name = "nvidia-curand-cu12", marker = "platform_machine == 'x86_64' and platform_system == 'Linux'" },
-    { name = "nvidia-cusolver-cu12", marker = "platform_machine == 'x86_64' and platform_system == 'Linux'" },
-    { name = "nvidia-cusparse-cu12", marker = "platform_machine == 'x86_64' and platform_system == 'Linux'" },
-    { name = "nvidia-cusparselt-cu12", marker = "platform_machine == 'x86_64' and platform_system == 'Linux'" },
-    { name = "nvidia-nccl-cu12", marker = "platform_machine == 'x86_64' and platform_system == 'Linux'" },
-    { name = "nvidia-nvjitlink-cu12", marker = "platform_machine == 'x86_64' and platform_system == 'Linux'" },
-    { name = "nvidia-nvtx-cu12", marker = "platform_machine == 'x86_64' and platform_system == 'Linux'" },
+    { name = "nvidia-cublas-cu12", marker = "platform_machine == 'x86_64' and sys_platform == 'linux'" },
+    { name = "nvidia-cuda-cupti-cu12", marker = "platform_machine == 'x86_64' and sys_platform == 'linux'" },
+    { name = "nvidia-cuda-nvrtc-cu12", marker = "platform_machine == 'x86_64' and sys_platform == 'linux'" },
+    { name = "nvidia-cuda-runtime-cu12", marker = "platform_machine == 'x86_64' and sys_platform == 'linux'" },
+    { name = "nvidia-cudnn-cu12", marker = "platform_machine == 'x86_64' and sys_platform == 'linux'" },
+    { name = "nvidia-cufft-cu12", marker = "platform_machine == 'x86_64' and sys_platform == 'linux'" },
+    { name = "nvidia-cufile-cu12", marker = "platform_machine == 'x86_64' and sys_platform == 'linux'" },
+    { name = "nvidia-curand-cu12", marker = "platform_machine == 'x86_64' and sys_platform == 'linux'" },
+    { name = "nvidia-cusolver-cu12", marker = "platform_machine == 'x86_64' and sys_platform == 'linux'" },
+    { name = "nvidia-cusparse-cu12", marker = "platform_machine == 'x86_64' and sys_platform == 'linux'" },
+    { name = "nvidia-cusparselt-cu12", marker = "platform_machine == 'x86_64' and sys_platform == 'linux'" },
+    { name = "nvidia-nccl-cu12", marker = "platform_machine == 'x86_64' and sys_platform == 'linux'" },
+    { name = "nvidia-nvjitlink-cu12", marker = "platform_machine == 'x86_64' and sys_platform == 'linux'" },
+    { name = "nvidia-nvtx-cu12", marker = "platform_machine == 'x86_64' and sys_platform == 'linux'" },
    { name = "setuptools", marker = "python_full_version >= '3.12'" },
    { name = "sympy" },
-    { name = "triton", marker = "platform_machine == 'x86_64' and platform_system == 'Linux'" },
+    { name = "triton", marker = "platform_machine == 'x86_64' and sys_platform == 'linux'" },
    { name = "typing-extensions" },
 ]
 wheels = [
@@ -4127,7 +4473,7 @@ name = "tqdm"
 version = "4.67.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "colorama", marker = "platform_system == 'Windows'" },
+    { name = "colorama", marker = "sys_platform == 'win32'" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/a8/4b/29b4ef32e036bb34e4ab51796dd745cdba7ed47ad142a9f4a1eb8e0c744d/tqdm-4.67.1.tar.gz", hash = "sha256:f8aef9c52c08c13a65f30ea34f4e5aac3fd1a34959879d7e59e63027286627f2", size = 169737 }
 wheels = [
@@ -4160,7 +4506,7 @@ name = "triton"
 version = "3.3.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "setuptools", marker = "(platform_machine != 'aarch64' and platform_system != 'Darwin') or (platform_system != 'Darwin' and platform_system != 'Linux' and sys_platform != 'linux')" },
+    { name = "setuptools", marker = "(platform_machine != 'aarch64' and sys_platform == 'linux') or (sys_platform != 'darwin' and sys_platform != 'linux' and sys_platform != 'win32')" },
 ]
 wheels = [
    { url = "https://files.pythonhosted.org/packages/21/2f/3e56ea7b58f80ff68899b1dbe810ff257c9d177d288c6b0f55bf2fe4eb50/triton-3.3.1-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b31e3aa26f8cb3cc5bf4e187bf737cbacf17311e1112b781d4a059353dfd731b", size = 155689937 },
@@ -4305,6 +4651,20 @@ wheels = [
    { url = "https://files.pythonhosted.org/packages/63/9a/0962b05b308494e3202d3f794a6e85abe471fe3cafdbcf95c2e8c713aabd/uvloop-0.21.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:a5c39f217ab3c663dc699c04cbd50c13813e31d917642d459fdcec07555cc553", size = 4660018 },
 ]

+[[package]]
+name = "virtualenv"
+version = "20.31.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "distlib" },
+    { name = "filelock" },
+    { name = "platformdirs" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/56/2c/444f465fb2c65f40c3a104fd0c495184c4f2336d65baf398e3c75d72ea94/virtualenv-20.31.2.tar.gz", hash = "sha256:e10c0a9d02835e592521be48b332b6caee6887f332c111aa79a09b9e79efc2af", size = 6076316 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f3/40/b1c265d4b2b62b58576588510fc4d1fe60a86319c8de99fd8e9fec617d2c/virtualenv-20.31.2-py3-none-any.whl", hash = "sha256:36efd0d9650ee985f0cad72065001e66d49a6f24eb44d98980f630686243cf11", size = 6057982 },
+]
+
 [[package]]
 name = "watchfiles"
 version = "1.1.0"
@@ -1,9 +1,16 @@
-# uv configuration file
+# uv configuration file for LandPPT
+
 # Extra index URLs for additional package sources
 extra-index-url = ["https://pypi.apryse.com"]

 # Use the fastest available index
 index-strategy = "first-index"

-# Cache configuration
-cache-dir = ".uv-cache"
+# Cache configuration - use project temp directory
+cache-dir = "temp/.uv-cache"
+
+# Python version preference
+python-preference = "managed"
+
+# Development dependencies (defined in pyproject.toml instead)
+# This section is moved to pyproject.toml [project.optional-dependencies]