# ai-tools

**Repository Path**: twell/ai-tools

## Basic Information

- **Project Name**: ai-tools
- **Description**: 全部工具
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-02
- **Last Updated**: 2026-02-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI Tools

AI Tools 是一个集成了多种人工智能相关功能的Python工具库，包括图像处理、转换等功能。

## 功能特性

### PNG 到 SVG 转换器
- 将 PNG 图像转换为真正的 SVG 矢量格式（而非仅嵌入）
- 支持命令行操作
- 提供简单的 API 接口

## 软件架构
本项目采用现代Python打包标准，使用 pyproject.toml 管理依赖和构建配置。

技术栈：
- Python >= 3.8
- Pillow: 图像处理
- Potrace: 位图到矢量图转换
- CairoSVG: SVG 处理
- NumPy: 数值计算

## 安装教程

1. 克隆本仓库
2. 安装依赖：`pip install -e .`
3. 或者直接安装：`pip install ai-tools`
4. 安装Potrace：
   - Windows: 下载并安装Potrace (https://potrace.sourceforge.net/#downloading)，然后将其添加到PATH环境变量
   - macOS: 使用Homebrew `brew install potrace`
   - Linux: 使用包管理器如 `sudo apt-get install potrace` 或 `sudo yum install potrace`

## 使用说明

### 准备工作
在使用本工具前，请确保：
1. 在项目根目录下创建 `input/` 目录，并放入需要转换的PNG文件
2. 在项目根目录下创建 `output/` 目录，用于存放转换后的SVG文件

### PNG 到 SVG 转换

#### 命令行使用
```bash
# 基本用法（请确保 input.png 存在于项目根目录）
python -m image_tools.png_to_svg input/logo.png output/logo.svg

# 或者使用脚本入口
png2svg input/logo.png output/logo.svg
```

#### 编程接口使用
```python
from image_tools.png_to_svg import png_to_svg

# 转换图像（请确保 input.png 存在于项目根目录）
svg_path = png_to_svg('input/logo.png', 'output/logo.svg')
print(f"转换完成: {svg_path}")
```

### 运行测试
```bash
python test/test_png_to_svg.py
```

## 开发指南

### 项目结构
```
ai-tools/
├── pyproject.toml          # 项目配置文件
├── README.md              # 项目说明文档
├── image_tools/           # 图像处理工具模块
│   ├── __init__.py
│   └── png_to_svg.py      # PNG转SVG功能实现
└── test/                  # 测试目录
    ├── __init__.py
    ├── input/             # 测试输入文件
    └── test_png_to_svg.py # PNG转SVG功能测试
```

## 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request

## 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件获取详情