# LiberTool

**Repository Path**: liberalchang/libertool

## Basic Information

- **Project Name**: LiberTool
- **Description**: 日常工具集，支持dify
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-24
- **Last Updated**: 2026-04-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LiberTool - 个人工具箱

高效工具集成平台，提供多种实用工具，包括JSON格式化、HTTP请求测试、时间戳转换等。

## 功能特点

- 多种工具分类，方便查找
- 简洁直观的用户界面
- 纯前端实现的工具，无需后端处理
- 支持摄影相关工具
- 融合智能体，高效解答问题

![image](https://liberc.oss-cn-shanghai.aliyuncs.com/mooe_img/2025%2F05%2F19b7da49be36fae20448e833d0fcd8a9.png)

## 安装与运行

### 环境要求

- Python 3.11+
- Node.js 18+ 和 npm 9+
- 推荐使用conda进行环境管理

### 基础安装

```bash
# 创建conda环境
conda create -n libertool python=3.11
conda activate libertool

# 安装Python依赖
pip install -r requirements.txt

# 安装前端依赖
npm install --force

# 启动应用
python main.py
```

### 开发者模式

```bash
# 安装开发依赖（包含测试工具和代码检查）
pip install -r requirements-dev.txt

# 安装前端开发工具
npm install --include=dev

# 启动开发服务器（支持热重载）
uvicorn main:app --reload --port 8000
```

### 环境变量配置

1. 复制环境模板文件：
```bash
cp .env.example .env
```
2. 按需修改配置参数：
```env
# 开发环境配置
DEBUG=true
PORT=8000
API_ENDPOINT=http://localhost:8000/api
```

### 常见问题

**Q: npm install报错**  
- 确认Node.js版本 ≥18  
- 清理缓存后重试：  
```bash
npm cache clean --force
rm -rf node_modules
npm install
```

**Q: Python依赖冲突**  
- 重建干净环境：  
```bash
conda deactivate
conda env remove -n libertool
conda create -n libertool python=3.11
```

**Q: 端口占用问题**  
修改启动端口：  
```bash
uvicorn main:app --reload --port 8001
```


### 运行应用

```bash
python main.py
```

应用将在 http://localhost:8000 启动

## 工具列表

- JSON格式化 - JSON数据美化与验证工具
- HTTP请求测试 - API接口调试工具
- 时间戳转换 - Unix时间戳与日期时间的互转换工具
- 编码转换工具 - Base64/URL/Unicode编码转换工具
- JSON编辑器 - 在线编辑与修改JSON数据
- IP地址查询 - 查询IP地址的详细信息
- 图片压缩 - 纯前端实现的图片压缩工具
- 二维码生成 - 文本/URL转二维码图片工具
- 摄影参数计算器 - 计算光圈、快门速度、ISO等摄影参数的工具
- 摄影天气查看 - 查看拍摄地点的天气情况，帮助规划拍摄时间

## 参考
- 视频下载：
项目地址：https://github.com/soimort/you-get.git

项目地址：https://github.com/xifangczy/cat-catch.git