AngeMedia Gateway v0.2.0

AngeMedia Gateway v0.2.0

This release establishes the first stable v0.2.0 foundation for AngeMedia Gateway: a self-hosted media generation gateway with a minimal Web Studio, safer provider handling, job/asset tracking, and Docker deployment support.

Highlights

• New minimal Web Studio for login, dashboard, image generation, providers, jobs, assets, gateway API keys, and account management.
• Single-admin account APIs and Web Studio account modal for username/password changes.
• Username/password changes require the current password and invalidate existing sessions.
• Gateway API Keys cannot access admin/account APIs.
• Catalog-aware image generation UI with clearer default/catalog/custom provider model handling.
• Provider catalog and built-in/reserved provider sections are read-only in v0.2.0 and configured through environment variables.
• Pollinations is disabled by default and treated as experimental.
• Image generation results are localized into protected assets.
• Video generation supports submit/status flows; there is no background worker queue in v0.2.0.
• Jobs and Assets provide a minimal usable tracking and browsing flow.
• /generated/* and /uploads/* are protected and support authenticated HEAD.
• Dockerfile, docker-compose example, and DockerHub publishing workflow added.

Docker

Images:

maxblack777/angemedia-gateway:v0.2.0
maxblack777/angemedia-gateway:latest

The latest tag is only published for stable version tags, not for main branch pushes.

Verified gates

• Full CI test suite passed on Python 3.10, 3.11, and 3.12.
• Web Studio JavaScript syntax check passed.
• GitHub Actions CI passed.
• Docker build and compose smoke passed.
• DockerHub workflow passed for main/edge before release.
• Remote staging previously passed real image/video E2E on the runtime commit; later commits were documentation and Docker packaging only.

Known limits

• Python 3.13 is not part of the v0.2.0 supported CI matrix.
• No Redis/Celery/K8s worker queue in v0.2.0.
• No SaaS, multi-tenant, billing, team workspace, or hosted control plane.
• No v0.1 data migration/backfill.
• Built-in provider credentials are still environment-driven, not fully editable through the Web Studio.
• Diagnostics, job event detail, provider fallback-chain UI, and richer provider management are planned for later versions.

AngeMedia Gateway v0.1.0

AngeMedia Gateway v0.1.0

从 Image Proxy Gateway 更名。

新增功能

• OpenAI 兼容图片生成端点，多 Provider 自动降级
• Agnes AI 视频生成（文生视频/图生视频/关键帧过渡）
• 自定义 Provider 管理（DB 存储，运行时热插拔）
• 提示词增强 API（规则引擎，保留用户意图）
• 路由推理 API（按内容类型自动选模型）
• 内置 Web Studio（生成队列+预览）
• 管理后台（Provider 管理/助手设置/配置管理）
• 网关认证（am- 前缀密钥生成）
• 媒体本地化（远端 URL → 稳定本地文件）
• Docker 支持（含 HEALTHCHECK）
• GitHub Actions CI + 自动打包发布

支持的 Provider

• SiliconFlow (Kolors) — 免费，默认链
• ModelScope (Qwen/FLUX/Z-Image/Z-Turbo) — 免费，50张/天
• Pollinations — 免费兜底
• OpenAI-compatible (gpt-image-2) — 付费，显式调用
• Agnes AI（图片+视频）— 免费额度
• 自定义 Provider — 任意 OpenAI 兼容端点

技术栈

• Python 3.10+ / FastAPI / SQLite
• OpenAI-compatible API
• Agent Skill（SKILL.md + docs/）

安装

git clone https://github.com/ang77712829/AngeMedia-gateway.git
cd AngeMedia-gateway
pip install -r requirements.txt
cp .env.example .env
# 编辑 .env 填入 API Key
python scripts/proxy.py

Docker

docker compose -f templates/docker-compose.yml up -d --build

文档

• README_CN.md — 中文说明
• DEVELOPMENT.md — 开发指南
• skill/SKILL.md — Agent 技能文档

Full Changelog: v0.2...v0.1.0