Upload 7 files

.env.example

@@ -0,0 +1,58 @@
+# Hugging Face Space 环境变量配置示例
+# 复制此文件并根据需要在 Space 设置中配置环境变量
+
+# ===========================================
+# 翻译服务配置（可选）
+# ===========================================
+#
+# 翻译功能主要用于以下表情包模板：
+# - dianzhongdian (典中典/入典): 自动将中文翻译成日文
+#
+# 注意：350+ 个表情包模板中，只有极少数需要翻译功能
+# 即使不配置翻译服务，应用也能正常工作
+# ===========================================
+
+# 翻译服务类型: openai 或 baidu (默认: openai)
+TRANSLATOR_TYPE=openai
+
+# 百度翻译配置
+BAIDU_TRANS_APPID=your_baidu_app_id
+BAIDU_TRANS_APIKEY=your_baidu_api_key
+
+# OpenAI 翻译配置
+OPENAI_API_BASE=https://api.openai.com/v1
+OPENAI_API_KEY=your_openai_api_key
+OPENAI_MODEL=gpt-3.5-turbo
+OPENAI_TIMEOUT=30
+
+# ===========================================
+# 应用配置
+# ===========================================
+
+# 日志级别: DEBUG, INFO, WARNING, ERROR
+LOG_LEVEL=INFO
+
+# GIF 处理配置
+GIF_MAX_SIZE=10.0
+GIF_MAX_FRAMES=100
+
+# ===========================================
+# 服务器配置（通常不需要修改）
+# ===========================================
+
+# 服务器主机和端口（Hugging Face Spaces 会自动设置）
+HOST=0.0.0.0
+PORT=2233
+
+# 主目录和配置目录（Docker 中已设置）
+HOME=/app
+XDG_CONFIG_HOME=/app/.config
+
+# ===========================================
+# 使用说明
+# ===========================================
+
+# 1. 在 Hugging Face Space 的 Settings 页面中添加环境变量
+# 2. 只需要添加你实际需要的变量
+# 3. 如果不配置翻译服务，应用仍然可以正常生成表情包
+# 4. 翻译功能主要用于处理非中文文本输入

.gitignore

@@ -0,0 +1,124 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Logs
+logs/
+*.log
+
+# Temporary files
+tmp/
+temp/

DEPLOYMENT.md

@@ -0,0 +1,185 @@
+# Hugging Face Space 部署指南
+
+本文档介绍如何将 Meme Generator Unified 部署到 Hugging Face Spaces。
+
+## 🔧 重要更新 (v2.1.0)
+
+**翻译服务配置已优化！** 现在默认使用 OpenAI 翻译服务，如果你设置了 OpenAI 配置，将不再需要百度翻译配置。
+## 📋 前置要求
+
+- Hugging Face 账户
+- Docker 镜像：`ghcr.io/syfantasy/meme-generator:latest`
+
+## 🚀 部署步骤
+
+### 1. 创建新的 Space
+
+1. 访问 [Hugging Face Spaces](https://huggingface.co/spaces)
+2. 点击 "Create new Space"
+3. 填写以下信息：
+   - **Space name**: `meme-generator-unified`
+   - **License**: MIT
+   - **SDK**: Docker
+   - **Hardware**: CPU basic (免费) 或 CPU upgrade (付费，性能更好)
+
+### 2. 配置 Space
+
+1. 将本目录下的所有文件上传到你的 Space 仓库
+2. 确保以下文件存在：
+   - `README.md` - Space 的主页面和配置
+   - `Dockerfile` - Docker 配置文件
+   - `.gitignore` - Git 忽略文件
+
+### 3. 配置说明
+
+#### README.md 配置
+```yaml
+---
+title: Meme Generator Unified
+emoji: 🎭
+colorFrom: blue
+colorTo: purple
+sdk: docker
+pinned: false
+license: mit
+app_port: 2233
+---
+```
+
+#### Dockerfile 配置
+```dockerfile
+FROM ghcr.io/syfantasy/meme-generator:latest
+
+# 设置工作目录
+WORKDIR /app
+
+# 创建必要的目录并设置权限，同时创建一个默认配置文件
+RUN mkdir -p /app/.config/meme_generator && \
+    chmod -R 777 /app/.config && \
+    echo '[meme]' > /app/.config/meme_generator/config.toml && \
+    echo 'load_builtin_memes = true' >> /app/.config/meme_generator/config.toml && \
+    echo 'meme_dirs = ["/data/contrib", "/data/emoji"]' >> /app/.config/meme_generator/config.toml && \
+    echo 'meme_disabled_list = []' >> /app/.config/meme_generator/config.toml && \
+    echo '' >> /app/.config/meme_generator/config.toml && \
+    echo '[server]' >> /app/.config/meme_generator/config.toml && \
+    echo 'host = "0.0.0.0"' >> /app/.config/meme_generator/config.toml && \
+    echo 'port = 2233' >> /app/.config/meme_generator/config.toml && \
+    echo '' >> /app/.config/meme_generator/config.toml && \
+    echo '[log]' >> /app/.config/meme_generator/config.toml && \
+    echo 'log_level = "INFO"' >> /app/.config/meme_generator/config.toml && \
+    chmod 666 /app/.config/meme_generator/config.toml
+
+# 暴露端口
+EXPOSE 2233
+
+# 设置环境变量
+ENV HOST=0.0.0.0
+ENV PORT=2233
+ENV HOME=/app
+ENV XDG_CONFIG_HOME=/app/.config
+
+CMD ["python", "-m", "meme_generator.app"]
+```
+
+### 4. 环境变量（可选）
+
+#### 翻译功能说明
+
+翻译功能主要用于以下表情包模板：
+
+- **dianzhongdian (典中典/入典)**: 当只提供一个文本时，会自动将中文翻译成日文显示
+  - 使用场景：制作"典中典"风格的黑白草图表情包
+  - 翻译方向：中文 → 日文
+  - 如果不配置翻译服务，该模板仍可使用，但需要手动提供两个文本（中文和日文）
+
+**注意**: 大部分表情包模板（350+ 个中的 99%）都不需要翻译功能，即使不配置翻译服务，应用也能正常工作。
+
+如果需要配置翻译服务，可以在 Space 设置中添加以下环境变量：
+
+#### 翻译服务配置
+- `TRANSLATOR_TYPE`: 翻译服务类型，可选值：
+  - `openai` - 使用 OpenAI 翻译（默认，推荐）
+  - `baidu` - 使用百度翻译
+
+#### 百度翻译
+- `BAIDU_TRANS_APPID`: 百度翻译 APP ID
+- `BAIDU_TRANS_APIKEY`: 百度翻译 API Key
+
+#### OpenAI 翻译
+- `OPENAI_API_BASE`: OpenAI API 基础URL
+- `OPENAI_API_KEY`: OpenAI API Key
+- `OPENAI_MODEL`: 使用的模型（默认：gpt-3.5-turbo）
+- `OPENAI_TIMEOUT`: 请求超时时间（秒，默认：30）
+
+#### 其他配置
+- `LOG_LEVEL`: 日志级别（默认：INFO）
+- `GIF_MAX_SIZE`: GIF 最大文件大小（MB，默认：10.0）
+- `GIF_MAX_FRAMES`: GIF 最大帧数（默认：100）
+
+### 5. 部署验证
+
+部署完成后，你可以：
+
+1. **访问 Web 界面**: 直接在 Space 页面使用
+2. **API 调用**: 使用 Space 的 URL 进行 API 调用
+3. **查看文档**: 访问 `/docs` 查看 API 文档
+
+## 🔧 故障排除
+
+### 常见问题
+
+1. **权限错误 (Permission denied)**
+   ```
+   PermissionError: [Errno 13] Permission denied: '/.config'
+   PermissionError: [Errno 13] Permission denied: '/app/.config/meme_generator/config.toml'
+   ```
+   **解决方案**:
+   - 确保 Dockerfile 中包含了目录创建和权限设置
+   - 设置正确的环境变量 `HOME=/app` 和 `XDG_CONFIG_HOME=/app/.config`
+   - 预先创建配置文件并设置写入权限 `chmod 666`
+   - 使用 `chmod 777` 确保目录有完全权限
+
+2. **容器启动失败**
+   - 检查 Dockerfile 语法
+   - 确认 Docker 镜像可访问
+   - 查看 Space 日志
+
+3. **端口访问问题**
+   - 确认 `app_port: 2233` 在 README.md 中正确设置
+   - 检查��器内服务是否绑定到 `0.0.0.0:2233`
+
+4. **内存不足**
+   - 考虑升级到付费的 CPU upgrade 硬件
+   - 优化 Docker 镜像大小
+
+### 日志查看
+
+在 Space 页面的 "Logs" 标签中可以查看：
+- 容器启动日志
+- 应用运行日志
+- 错误信息
+
+## 📊 性能优化
+
+### 硬件选择
+- **CPU basic**: 免费，适合轻量使用
+- **CPU upgrade**: 付费，更好的性能和稳定性
+- **GPU**: 如果有图像处理需求可考虑
+
+### 缓存优化
+- Docker 镜像会被缓存，重复部署速度更快
+- 应用启动后会保持运行状态
+
+## 🔗 相关链接
+
+- [Hugging Face Spaces 文档](https://huggingface.co/docs/hub/spaces)
+- [Docker SDK 指南](https://huggingface.co/docs/hub/spaces-sdks-docker)
+- [项目 GitHub 仓库](https://github.com/syfantasy/meme-generator-unified)
+- [Docker 镜像](https://ghcr.io/syfantasy/meme-generator:latest)
+
+## 📞 支持
+
+如果遇到问题，可以：
+1. 查看 Space 日志
+2. 检查 GitHub 仓库的 Issues
+3. 参考项目文档中的故障排除指南

Dockerfile

@@ -0,0 +1,35 @@
+FROM ghcr.io/1111qwq1111/meme-generator:latest
+
+# 设置工作目录
+WORKDIR /app
+
+# 创建必要的目录并设置权限，同时创建一个默认配置文件
+RUN mkdir -p /app/.config/meme_generator && \
+    chmod -R 777 /app/.config && \
+    echo '[meme]' > /app/.config/meme_generator/config.toml && \
+    echo 'load_builtin_memes = true' >> /app/.config/meme_generator/config.toml && \
+    echo 'meme_dirs = ["/data/contrib", "/data/emoji"]' >> /app/.config/meme_generator/config.toml && \
+    echo 'meme_disabled_list = []' >> /app/.config/meme_generator/config.toml && \
+    echo '' >> /app/.config/meme_generator/config.toml && \
+    echo '[server]' >> /app/.config/meme_generator/config.toml && \
+    echo 'host = "0.0.0.0"' >> /app/.config/meme_generator/config.toml && \
+    echo 'port = 2233' >> /app/.config/meme_generator/config.toml && \
+    echo '' >> /app/.config/meme_generator/config.toml && \
+    echo '[translate]' >> /app/.config/meme_generator/config.toml && \
+    echo 'translator_type = "openai"' >> /app/.config/meme_generator/config.toml && \
+    echo '' >> /app/.config/meme_generator/config.toml && \
+    echo '[log]' >> /app/.config/meme_generator/config.toml && \
+    echo 'log_level = "INFO"' >> /app/.config/meme_generator/config.toml && \
+    chmod 666 /app/.config/meme_generator/config.toml
+
+# 暴露端口
+EXPOSE 2233
+
+# 设置环境变量
+ENV HOST=0.0.0.0
+ENV PORT=2233
+ENV HOME=/app
+ENV XDG_CONFIG_HOME=/app/.config
+
+# 启动命令
+CMD ["python", "-m", "meme_generator.app"]

README.md

@@ -1,11 +1,57 @@
----
-title: Meme
-emoji: 📈
-colorFrom: pink
-colorTo: red
-sdk: docker
-pinned: false
-short_description: meme
----
-
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+---
+title: Meme Generator Unified
+emoji: 🎭
+colorFrom: blue
+colorTo: purple
+sdk: docker
+pinned: false
+license: mit
+app_port: 2233
+---
+
+# Meme Generator Unified
+
+一个功能强大的表情包生成器，整合了350+个表情包模板，支持多种风格和类型的表情包制作。
+
+## 🚀 功能特性
+
+- **丰富模板**: 350+ 个表情包模板
+- **多种类型**: 支持静态图片和动态GIF
+- **API接口**: 完整的RESTful API
+- **翻译支持**: 集成百度翻译和OpenAI翻译
+- **高质量输出**: 支持多种图片格式和分辨率
+
+## 📖 使用方法
+
+### Web界面
+访问应用后，可以通过Web界面选择模板并生成表情包。
+
+### API调用
+```bash
+# 获取所有可用的表情包模板
+curl https://your-space-url/memes/keys
+
+# 生成表情包
+curl -X POST https://your-space-url/memes/petpet/ \
+  -F "images=@your-image.jpg"
+```
+
+## 🛠️ 技术栈
+
+- **后端**: FastAPI + Python
+- **图像处理**: Pillow + OpenCV
+- **容器化**: Docker
+- **部署**: Hugging Face Spaces
+
+## 📚 API文档
+
+启动后访问 `/docs` 查看完整的API文档。
+
+## 🔗 相关链接
+
+- [GitHub仓库](https://github.com/syfantasy/meme-generator-unified)
+- [Docker镜像](https://ghcr.io/syfantasy/meme-generator:latest)
+
+## 📄 许可证
+
+本项目采用 MIT 许可证。

app.py

@@ -0,0 +1,54 @@
+#!/usr/bin/env python3
+"""
+Hugging Face Space 启动脚本
+主要使用 Docker 部署，此文件作为备用
+"""
+
+import os
+import sys
+import subprocess
+from pathlib import Path
+
+def main():
+    """主启动函数"""
+    print("🎭 Meme Generator Unified - Hugging Face Space")
+    print("=" * 50)
+    
+    # 检查是否在容器环境中
+    if os.path.exists("/.dockerenv"):
+        print("✅ 检测到 Docker 容器环境")
+        
+        # 设置环境变量
+        os.environ.setdefault("HOST", "0.0.0.0")
+        os.environ.setdefault("PORT", "2233")
+        
+        print(f"🌐 服务将启动在: {os.environ['HOST']}:{os.environ['PORT']}")
+        
+        try:
+            # 启动应用
+            print("🚀 启动 Meme Generator 服务...")
+            subprocess.run([
+                sys.executable, "-m", "meme_generator.app"
+            ], check=True)
+        except subprocess.CalledProcessError as e:
+            print(f"❌ 启动失败: {e}")
+            sys.exit(1)
+        except KeyboardInterrupt:
+            print("\n👋 服务已停止")
+            sys.exit(0)
+    else:
+        print("⚠️  未检测到 Docker 环境")
+        print("📖 请参考 DEPLOYMENT.md 了解正确的部署方式")
+        print("🐳 推荐使用 Docker 部署: ghcr.io/syfantasy/meme-generator:latest")
+        
+        # 显示帮助信息
+        print("\n📋 部署步骤:")
+        print("1. 确保所有文件已上传到 Hugging Face Space")
+        print("2. 检查 README.md 中的配置")
+        print("3. 确认 Dockerfile 正确")
+        print("4. Space 会自动构建和部署")
+        
+        sys.exit(1)
+
+if __name__ == "__main__":
+    main()

requirements.txt

@@ -0,0 +1,32 @@
+# 本文件仅作为参考，实际依赖已包含在 Docker 镜像中
+# Docker 镜像: ghcr.io/syfantasy/meme-generator:latest
+
+# 核心依赖
+fastapi>=0.104.0
+uvicorn[standard]>=0.24.0
+pillow>=10.0.0
+opencv-python-headless>=4.8.0
+numpy>=1.24.0
+pydantic>=2.0.0
+toml>=0.10.2
+
+# 翻译服务
+requests>=2.31.0
+openai>=1.0.0
+
+# 图像处理
+imageio>=2.31.0
+imageio-ffmpeg>=0.4.8
+
+# 字体支持
+fonttools>=4.42.0
+
+# 工具库
+python-multipart>=0.0.6
+jinja2>=3.1.2
+aiofiles>=23.2.1
+
+# 开发工具（可选）
+pytest>=7.4.0
+black>=23.7.0
+isort>=5.12.0