meme-generator-next 0.2.0__tar.gz

meme_generator_next-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 chiskat
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

meme_generator_next-0.2.0/PKG-INFO

@@ -0,0 +1,169 @@
+Metadata-Version: 2.4
+Name: meme-generator-next
+Version: 0.2.0
+Summary: The next-generation Python version of meme-generator
+License: MIT
+License-File: LICENSE
+Author: chiskat
+Author-email: 1@paperplane.cc
+Requires-Python: >=3.10,<4.0
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: Pillow (>=12.3.0,<13.0.0)
+Requires-Dist: arclet-alconna (>=1.8.23,<2.0.0,!=1.8.27)
+Requires-Dist: arclet-alconna-tools (>=0.7.9,<0.8.0)
+Requires-Dist: boto3 (>=1.35.0,<2.0.0)
+Requires-Dist: dateparser (>=1.2.0,<2.0.0)
+Requires-Dist: fastapi (>=0.93.0,<1.0.0)
+Requires-Dist: filetype (>=1.2.0,<2.0.0)
+Requires-Dist: httpx (>=0.20.0,<1.0.0)
+Requires-Dist: loguru (>=0.6.0,<1.0.0)
+Requires-Dist: pil-utils-fix-deps (>=0.2.0,<0.3.0)
+Requires-Dist: pycairo (>=1.26.0)
+Requires-Dist: python-multipart (>=0.0.9,<0.1.0,!=0.0.13,!=0.0.14)
+Requires-Dist: qrcode (>=8.0,<9.0)
+Requires-Dist: redis (>=5.0.0,<6.0.0)
+Requires-Dist: rich (>=13.0.0,<14.0.0)
+Requires-Dist: skia-python (>=138.0)
+Requires-Dist: toml (>=0.10.2,<0.11.0)
+Requires-Dist: typing-extensions (>=4.4.0,<5.0.0)
+Requires-Dist: uvicorn (>=0.20.0,<1.0.0)
+Project-URL: Homepage, https://github.com/chiskat/meme-generator-next
+Project-URL: Repository, https://github.com/chiskat/meme-generator-next
+Description-Content-Type: text/markdown
+
+# meme-generator-next
+
+本项目 fork 自 [MemeCrafters/meme-generator](https://github.com/MemeCrafters/meme-generator)。
+
+特性升级：
+
+- 处理了 `Pillow` 和 `pil-utils` 的依赖版本，以避免和 Astrbot 新版本不兼容；
+- 依赖项包含 `pycairo`，因此在加载 [meme_emoji](https://github.com/anyliew/meme_emoji) 时不再提示缺少依赖；
+- 支持自定义 `config.toml` 文件路径，详见 [配置文件路径](#配置文件路径)；
+- 支持自动上传 S3 并返回 URL；
+- 支持通过 Redis 连接，缓存预览图。
+
+# 特性升级介绍
+
+## 配置文件路径
+
+作为包导入或 Docker 部署时，可通过 `MEME_GENERATOR_CONFIG_FILE` 指定配置文件路径，文件名不必为 `config.toml`：
+
+```yaml
+services:
+  meme-generator:
+    volumes:
+      - ./config:/config
+    environment:
+      MEME_GENERATOR_CONFIG_FILE: /config/config.toml
+```
+
+命令行启动时，可使用 `--config-file` 参数指定配置文件路径：
+
+```bash
+# CLI 用法
+meme --config-file /path/to/config.toml run
+
+# Web Server
+python -m meme_generator.app --config-file=/path/to/config.toml
+```
+
+兼容说明：旧版本的 `MEME_GENERATOR_CONFIG_DIR` 环境变量（目录形式）仍然有效，但已不推荐使用；`--config-dir` 参数已被 `--config-file` 取代。
+
+## S3 存储
+
+在 `config.toml` 中启用 S3 后，HTTP Server 会为每个表情新增一个 `/memes/{key}/url/` 端点。该端点的请求参数与原有的 `/memes/{key}/` 端点完全相同，生成成功后会自动上传到 S3，并返回 JSON：
+
+```json
+{
+  "url": "https://cdn.example.com/meme-generator/artifact/petpet/xxx.gif",
+  "meme_key": "petpet",
+  "object_key": "meme-generator/artifact/petpet/xxx.gif"
+}
+```
+
+生成结果的对象名格式为 `{result_prefix}/{meme_key}/{random_key}.{extension}`，预览图为 `{preview_prefix}/{meme_key}/{random_key}.{extension}`。其中 `random_key` 为 32 位 UUID 随机十六进制字符串，不包含日期。
+
+生成结果和预览图分别使用 `result_prefix` 与 `preview_prefix`，没有通用对象前缀配置。
+
+配置示例：
+
+```toml
+[storage.s3]
+enabled = true
+# 自定义 S3 兼容服务地址；AWS 官方 S3 可以留空
+endpoint_url = "https://s3.example.com"
+region = "ap-northeast-1"
+bucket = "meme-generator"
+access_key_id = "your-access-key-id"
+secret_access_key = "your-secret-access-key"
+# 生成结果前缀
+result_prefix = "meme-generator/artifact"
+# 预览图前缀
+preview_prefix = "meme-generator/preview"
+# 推荐配置为 bucket 的公开访问地址；留空时会根据 endpoint/region 生成 S3 URL
+public_base_url = "https://cdn.example.com"
+# 大多数 S3 兼容服务（MinIO、Cloudflare R2 等）需要 path_style = true
+path_style = true
+```
+
+返回的 `url` 需要能被访问；如果使用私有 bucket，请将 `public_base_url` 指向具有读取权限的 CDN/反向代理，或自行生成预签名 URL。
+
+Docker 部署时，也可以使用环境变量来配置：
+
+```yaml
+services:
+  meme-generator:
+    environment:
+      S3_ENABLED: 'true'
+      S3_ENDPOINT_URL: 'https://s3.example.com'
+      S3_REGION: 'ap-northeast-1'
+      S3_BUCKET: 'meme-generator'
+      S3_ACCESS_KEY_ID: 'your-access-key-id'
+      S3_SECRET_ACCESS_KEY: 'your-secret-access-key'
+      S3_SESSION_TOKEN: ''
+      S3_RESULT_PREFIX: 'meme-generator/artifact'
+      S3_PREVIEW_PREFIX: 'meme-generator/preview'
+      S3_PUBLIC_BASE_URL: 'https://cdn.example.com'
+      S3_PATH_STYLE: 'true'
+```
+
+## Redis 预览缓存
+
+启用 S3 和 Redis 后，每个表情都会新增 `GET /memes/{key}/preview/url/` 端点。第一次访问时会生成预览图并上传到 S3，然后将返回的公开 URL 写入 Redis；后续访问会直接返回缓存中的 URL：
+
+```json
+{
+  "url": "https://cdn.example.com/meme-generator/preview/petpet/xxx.gif",
+  "meme_key": "petpet"
+}
+```
+
+Redis 配置示例：
+
+```toml
+[storage.redis]
+enabled = true
+url = "redis://localhost:6379/0"
+key_prefix = "meme-generator:preview"
+```
+
+`key_prefix` 用于区分不同部署的缓存键。缓存写入时不设置过期时间；如果 Redis 配置了 `maxmemory-policy`，请避免选择会主动删除键的淘汰策略，或使用专门的 Redis 实例。
+
+Docker 部署时，也可以使用环境变量来配置：
+
+```yaml
+services:
+  meme-generator:
+    environment:
+      REDIS_ENABLED: 'true'
+      REDIS_URL: 'redis://localhost:6379/0'
+      REDIS_KEY_PREFIX: 'meme-generator:preview'
+```
+

meme_generator_next-0.2.0/README.md

@@ -0,0 +1,129 @@
+# meme-generator-next
+
+本项目 fork 自 [MemeCrafters/meme-generator](https://github.com/MemeCrafters/meme-generator)。
+
+特性升级：
+
+- 处理了 `Pillow` 和 `pil-utils` 的依赖版本，以避免和 Astrbot 新版本不兼容；
+- 依赖项包含 `pycairo`，因此在加载 [meme_emoji](https://github.com/anyliew/meme_emoji) 时不再提示缺少依赖；
+- 支持自定义 `config.toml` 文件路径，详见 [配置文件路径](#配置文件路径)；
+- 支持自动上传 S3 并返回 URL；
+- 支持通过 Redis 连接，缓存预览图。
+
+# 特性升级介绍
+
+## 配置文件路径
+
+作为包导入或 Docker 部署时，可通过 `MEME_GENERATOR_CONFIG_FILE` 指定配置文件路径，文件名不必为 `config.toml`：
+
+```yaml
+services:
+  meme-generator:
+    volumes:
+      - ./config:/config
+    environment:
+      MEME_GENERATOR_CONFIG_FILE: /config/config.toml
+```
+
+命令行启动时，可使用 `--config-file` 参数指定配置文件路径：
+
+```bash
+# CLI 用法
+meme --config-file /path/to/config.toml run
+
+# Web Server
+python -m meme_generator.app --config-file=/path/to/config.toml
+```
+
+兼容说明：旧版本的 `MEME_GENERATOR_CONFIG_DIR` 环境变量（目录形式）仍然有效，但已不推荐使用；`--config-dir` 参数已被 `--config-file` 取代。
+
+## S3 存储
+
+在 `config.toml` 中启用 S3 后，HTTP Server 会为每个表情新增一个 `/memes/{key}/url/` 端点。该端点的请求参数与原有的 `/memes/{key}/` 端点完全相同，生成成功后会自动上传到 S3，并返回 JSON：
+
+```json
+{
+  "url": "https://cdn.example.com/meme-generator/artifact/petpet/xxx.gif",
+  "meme_key": "petpet",
+  "object_key": "meme-generator/artifact/petpet/xxx.gif"
+}
+```
+
+生成结果的对象名格式为 `{result_prefix}/{meme_key}/{random_key}.{extension}`，预览图为 `{preview_prefix}/{meme_key}/{random_key}.{extension}`。其中 `random_key` 为 32 位 UUID 随机十六进制字符串，不包含日期。
+
+生成结果和预览图分别使用 `result_prefix` 与 `preview_prefix`，没有通用对象前缀配置。
+
+配置示例：
+
+```toml
+[storage.s3]
+enabled = true
+# 自定义 S3 兼容服务地址；AWS 官方 S3 可以留空
+endpoint_url = "https://s3.example.com"
+region = "ap-northeast-1"
+bucket = "meme-generator"
+access_key_id = "your-access-key-id"
+secret_access_key = "your-secret-access-key"
+# 生成结果前缀
+result_prefix = "meme-generator/artifact"
+# 预览图前缀
+preview_prefix = "meme-generator/preview"
+# 推荐配置为 bucket 的公开访问地址；留空时会根据 endpoint/region 生成 S3 URL
+public_base_url = "https://cdn.example.com"
+# 大多数 S3 兼容服务（MinIO、Cloudflare R2 等）需要 path_style = true
+path_style = true
+```
+
+返回的 `url` 需要能被访问；如果使用私有 bucket，请将 `public_base_url` 指向具有读取权限的 CDN/反向代理，或自行生成预签名 URL。
+
+Docker 部署时，也可以使用环境变量来配置：
+
+```yaml
+services:
+  meme-generator:
+    environment:
+      S3_ENABLED: 'true'
+      S3_ENDPOINT_URL: 'https://s3.example.com'
+      S3_REGION: 'ap-northeast-1'
+      S3_BUCKET: 'meme-generator'
+      S3_ACCESS_KEY_ID: 'your-access-key-id'
+      S3_SECRET_ACCESS_KEY: 'your-secret-access-key'
+      S3_SESSION_TOKEN: ''
+      S3_RESULT_PREFIX: 'meme-generator/artifact'
+      S3_PREVIEW_PREFIX: 'meme-generator/preview'
+      S3_PUBLIC_BASE_URL: 'https://cdn.example.com'
+      S3_PATH_STYLE: 'true'
+```
+
+## Redis 预览缓存
+
+启用 S3 和 Redis 后，每个表情都会新增 `GET /memes/{key}/preview/url/` 端点。第一次访问时会生成预览图并上传到 S3，然后将返回的公开 URL 写入 Redis；后续访问会直接返回缓存中的 URL：
+
+```json
+{
+  "url": "https://cdn.example.com/meme-generator/preview/petpet/xxx.gif",
+  "meme_key": "petpet"
+}
+```
+
+Redis 配置示例：
+
+```toml
+[storage.redis]
+enabled = true
+url = "redis://localhost:6379/0"
+key_prefix = "meme-generator:preview"
+```
+
+`key_prefix` 用于区分不同部署的缓存键。缓存写入时不设置过期时间；如果 Redis 配置了 `maxmemory-policy`，请避免选择会主动删除键的淘汰策略，或使用专门的 Redis 实例。
+
+Docker 部署时，也可以使用环境变量来配置：
+
+```yaml
+services:
+  meme-generator:
+    environment:
+      REDIS_ENABLED: 'true'
+      REDIS_URL: 'redis://localhost:6379/0'
+      REDIS_KEY_PREFIX: 'meme-generator:preview'
+```

meme_generator_next-0.2.0/meme_generator/__init__.py

@@ -0,0 +1,59 @@
+import argparse
+import os
+import sys
+from pathlib import Path
+
+CONFIG_FILE_ENV = "MEME_GENERATOR_CONFIG_FILE"
+
+
+def _is_module_invocation(module_name: str) -> bool:
+    orig_argv = getattr(sys, "orig_argv", [])
+    try:
+        option_index = orig_argv.index("-m")
+    except ValueError:
+        return False
+    return (
+        option_index + 1 < len(orig_argv) and orig_argv[option_index + 1] == module_name
+    )
+
+
+def _apply_config_file_option() -> None:
+    if not _is_module_invocation("meme_generator.app"):
+        return
+
+    parser = argparse.ArgumentParser(add_help=False, allow_abbrev=False)
+    parser.add_argument("--config-file", dest="config_file")
+    args, remaining = parser.parse_known_args(sys.argv[1:])
+
+    if args.config_file is None:
+        return
+    if not args.config_file:
+        parser.error("--config-file must not be empty")
+
+    os.environ[CONFIG_FILE_ENV] = str(Path(args.config_file).expanduser())
+    sys.argv[:] = [sys.argv[0], *remaining]
+
+
+_apply_config_file_option()
+
+from meme_generator.config import meme_config as config
+from meme_generator.manager import add_meme as add_meme
+from meme_generator.manager import get_meme as get_meme
+from meme_generator.manager import get_meme_keys as get_meme_keys
+from meme_generator.manager import get_memes as get_memes
+from meme_generator.manager import load_meme as load_meme
+from meme_generator.manager import load_memes as load_memes
+from meme_generator.meme import CommandShortcut as CommandShortcut
+from meme_generator.meme import Meme as Meme
+from meme_generator.meme import MemeArgsModel as MemeArgsModel
+from meme_generator.meme import MemeArgsType as MemeArgsType
+from meme_generator.meme import MemeParamsType as MemeParamsType
+from meme_generator.meme import ParserArg as ParserArg
+from meme_generator.meme import ParserOption as ParserOption
+from meme_generator.version import __version__ as __version__
+
+if config.meme.load_builtin_memes:
+    for path in (Path(__file__).parent / "memes").iterdir():
+        load_meme(f"meme_generator.memes.{path.name}")
+for meme_dir in config.meme.meme_dirs:
+    load_memes(meme_dir)

meme_generator_next-0.2.0/meme_generator/app.py

@@ -0,0 +1,322 @@
+import json
+from datetime import datetime
+from typing import Any, Literal, Optional
+
+import filetype
+from fastapi import Depends, FastAPI, Form, HTTPException, Response, UploadFile
+from pydantic import BaseModel, ValidationError
+from redis.exceptions import RedisError
+
+from meme_generator.compat import model_dump, model_json_schema, type_validate_python
+from meme_generator.config import meme_config
+from meme_generator.exception import (
+    ArgModelMismatch,
+    MemeGeneratorException,
+    NoSuchMeme,
+    RedisCacheError,
+    S3StorageError,
+)
+from meme_generator.log import LOGGING_CONFIG, setup_logger
+from meme_generator.manager import get_meme, get_meme_keys, get_memes
+from meme_generator.meme import CommandShortcut, Meme, MemeArgsModel, ParserOption
+from meme_generator.redis_cache import (
+    cache_preview_url,
+    create_redis_client,
+    get_cached_preview_url,
+)
+from meme_generator.storage import upload_to_s3
+from meme_generator.utils import MemeProperties, render_meme_list, run_sync
+from meme_generator.version import __version__
+
+app = FastAPI()
+
+
+class MemeArgsResponse(BaseModel):
+    args_model: dict[str, Any]
+    args_examples: list[dict[str, Any]]
+    parser_options: list[ParserOption]
+
+
+class MemeParamsResponse(BaseModel):
+    min_images: int
+    max_images: int
+    min_texts: int
+    max_texts: int
+    default_texts: list[str]
+    args_type: Optional[MemeArgsResponse] = None
+
+
+class MemeUrlResponse(BaseModel):
+    url: str
+    meme_key: str
+    object_key: str
+
+
+class MemePreviewUrlResponse(BaseModel):
+    url: str
+    meme_key: str
+
+
+class MemeInfoResponse(BaseModel):
+    key: str
+    params_type: MemeParamsResponse
+    keywords: list[str]
+    shortcuts: list[CommandShortcut]
+    tags: set[str]
+    date_created: datetime
+    date_modified: datetime
+
+
+async def generate_meme(
+    meme: Meme, images: list[bytes], texts: list[str], args: Any
+) -> tuple[bytes, str]:
+    try:
+        result = await run_sync(meme)(images=images, texts=texts, args=model_dump(args))
+    except MemeGeneratorException as e:
+        raise HTTPException(status_code=e.status_code, detail=e.message)
+
+    content = result.getvalue()
+    media_type = str(filetype.guess_mime(content)) or "text/plain"
+    return content, media_type
+
+
+def register_router(meme: Meme):
+    if args_type := meme.params_type.args_type:
+        args_model = args_type.args_model
+    else:
+        args_model = MemeArgsModel
+
+    def args_checker(
+        args: Optional[str] = Form(default=json.dumps(model_dump(args_model()))),
+    ):
+        if not args:
+            return MemeArgsModel()
+        try:
+            model = type_validate_python(args_model, json.loads(args))
+        except ValidationError as e:
+            e = ArgModelMismatch(str(e))
+            raise HTTPException(status_code=552, detail=e.message)
+        return model
+
+    @app.post(f"/memes/{meme.key}/")
+    async def _(
+        images: list[UploadFile] = [],
+        texts: list[str] = meme.params_type.default_texts,
+        args: args_model = Depends(args_checker),  # type: ignore
+    ):
+        imgs: list[bytes] = []
+        for image in images:
+            imgs.append(await image.read())
+
+        texts = [text for text in texts if text]
+
+        assert isinstance(args, args_model)
+
+        content, media_type = await generate_meme(meme, imgs, texts, args)
+
+        return Response(content=content, media_type=media_type)
+
+    @app.post(f"/memes/{meme.key}/url/")
+    async def _(
+        images: list[UploadFile] = [],
+        texts: list[str] = meme.params_type.default_texts,
+        args: args_model = Depends(args_checker),  # type: ignore
+    ):
+        imgs: list[bytes] = []
+        for image in images:
+            imgs.append(await image.read())
+
+        texts = [text for text in texts if text]
+
+        assert isinstance(args, args_model)
+
+        content, media_type = await generate_meme(meme, imgs, texts, args)
+
+        try:
+            upload_result = await run_sync(upload_to_s3)(
+                content=content,
+                media_type=media_type,
+                meme_key=meme.key,
+                config=meme_config.storage.s3,
+                upload_kind="result",
+            )
+        except S3StorageError as e:
+            raise HTTPException(status_code=e.status_code, detail=e.message)
+
+        return MemeUrlResponse(
+            url=upload_result.url,
+            meme_key=meme.key,
+            object_key=upload_result.object_key,
+        )
+
+    @app.get(f"/memes/{meme.key}/preview/url/")
+    async def _():
+        redis_config = meme_config.storage.redis
+        if not redis_config.enabled:
+            error = RedisCacheError(
+                "Redis 缓存未启用，请在 config.toml 中配置 storage.redis"
+            )
+            raise HTTPException(status_code=error.status_code, detail=error.message)
+
+        try:
+            redis_client = create_redis_client(redis_config)
+        except RedisCacheError as e:
+            raise HTTPException(status_code=e.status_code, detail=e.message)
+
+        try:
+            cached_url = await get_cached_preview_url(
+                redis_client, redis_config, meme.key
+            )
+            if cached_url:
+                return MemePreviewUrlResponse(url=cached_url, meme_key=meme.key)
+
+            try:
+                result = await run_sync(meme.generate_preview)()
+            except MemeGeneratorException as e:
+                raise HTTPException(status_code=e.status_code, detail=e.message)
+
+            content = result.getvalue()
+            media_type = str(filetype.guess_mime(content)) or "text/plain"
+
+            try:
+                upload_result = await run_sync(upload_to_s3)(
+                    content=content,
+                    media_type=media_type,
+                    meme_key=meme.key,
+                    config=meme_config.storage.s3,
+                    upload_kind="preview",
+                )
+            except S3StorageError as e:
+                raise HTTPException(status_code=e.status_code, detail=e.message)
+
+            try:
+                await cache_preview_url(
+                    redis_client, redis_config, meme.key, upload_result.url
+                )
+            except RedisError as e:
+                error = RedisCacheError(f"Redis 缓存写入失败：{e}")
+                raise HTTPException(status_code=error.status_code, detail=error.message)
+
+            return MemePreviewUrlResponse(url=upload_result.url, meme_key=meme.key)
+        except RedisError as e:
+            error = RedisCacheError(f"Redis 缓存读取失败：{e}")
+            raise HTTPException(status_code=error.status_code, detail=error.message)
+        finally:
+            await redis_client.aclose()
+
+
+class MemeKeyWithProperties(BaseModel):
+    meme_key: str
+    disabled: bool = False
+    labels: list[Literal["new", "hot"]] = []
+
+
+default_meme_list = [
+    MemeKeyWithProperties(meme_key=meme.key)
+    for meme in sorted(get_memes(), key=lambda meme: meme.key)
+]
+
+
+class RenderMemeListRequest(BaseModel):
+    meme_list: list[MemeKeyWithProperties] = default_meme_list
+    text_template: str = "{keywords}"
+    add_category_icon: bool = True
+
+
+def register_routers():
+    @app.post("/memes/render_list")
+    def _(params: RenderMemeListRequest = RenderMemeListRequest()):
+        try:
+            meme_list = [
+                (
+                    get_meme(p.meme_key),
+                    MemeProperties(disabled=p.disabled, labels=p.labels),
+                )
+                for p in params.meme_list
+            ]
+        except NoSuchMeme as e:
+            raise HTTPException(status_code=e.status_code, detail=e.message)
+
+        result = render_meme_list(
+            meme_list,
+            text_template=params.text_template,
+            add_category_icon=params.add_category_icon,
+        )
+        content = result.getvalue()
+        media_type = str(filetype.guess_mime(content)) or "text/plain"
+        return Response(content=content, media_type=media_type)
+
+    @app.get("/meme/version")
+    def _():
+        return __version__
+
+    @app.get("/memes/keys")
+    def _():
+        return get_meme_keys()
+
+    @app.get("/memes/{key}/info")
+    def _(key: str):
+        try:
+            meme = get_meme(key)
+        except NoSuchMeme as e:
+            raise HTTPException(status_code=e.status_code, detail=e.message)
+
+        args_type_response = None
+        if args_type := meme.params_type.args_type:
+            args_model = args_type.args_model
+            args_type_response = MemeArgsResponse(
+                args_model=model_json_schema(args_model),
+                args_examples=[
+                    model_dump(example) for example in args_type.args_examples
+                ],
+                parser_options=args_type.parser_options,
+            )
+
+        return MemeInfoResponse(
+            key=meme.key,
+            params_type=MemeParamsResponse(
+                min_images=meme.params_type.min_images,
+                max_images=meme.params_type.max_images,
+                min_texts=meme.params_type.min_texts,
+                max_texts=meme.params_type.max_texts,
+                default_texts=meme.params_type.default_texts,
+                args_type=args_type_response,
+            ),
+            keywords=meme.keywords,
+            shortcuts=meme.shortcuts,
+            tags=meme.tags,
+            date_created=meme.date_created,
+            date_modified=meme.date_modified,
+        )
+
+    @app.get("/memes/{key}/preview")
+    async def _(key: str):
+        try:
+            meme = get_meme(key)
+            result = await run_sync(meme.generate_preview)()
+        except MemeGeneratorException as e:
+            raise HTTPException(status_code=e.status_code, detail=e.message)
+
+        content = result.getvalue()
+        media_type = str(filetype.guess_mime(content)) or "text/plain"
+        return Response(content=content, media_type=media_type)
+
+    for meme in sorted(get_memes(), key=lambda meme: meme.key):
+        register_router(meme)
+
+
+def run_server():
+    import uvicorn
+
+    register_routers()
+    uvicorn.run(
+        app,
+        host=meme_config.server.host,
+        port=meme_config.server.port,
+        log_config=LOGGING_CONFIG,
+    )
+
+
+if __name__ == "__main__":
+    setup_logger()
+    run_server()