Releases: AngeVox/AngeMedia-gateway
Release list
AngeMedia Gateway v0.2.1
AngeMedia Gateway v0.2.1
EN · Release Card
Version: v0.2.1
Release type: Stability, security, Web Studio, queue runtime, and release-hygiene update
Recommended users: Self-hosted users, AI Agent integrations, NAS deployments, New API/OpenAI-compatible media workflows
Git tag: v0.2.1
Docker image: maxblack777/angemedia-gateway:v0.2.1
Latest image: maxblack777/angemedia-gateway:latest
Highlights
- Web Studio now covers image generation, video generation, jobs, assets, channels, diagnostics, API keys, and assistant settings.
- Queue-first generation path with dispatcher and worker processes.
- Agnes Video v2.0 is the primary released video path.
- SiliconFlow/Kolors is documented as the stable image-to-image path.
- Generated and uploaded media are localized into protected
/generated/*and/uploads/*paths. - Public README, Chinese README, skill docs, and release notes were refreshed for external users.
- Release packaging hygiene now excludes known internal audit, handoff, release-report, development, design QA, and assistant execution-plan files.
- Job/error sanitization was hardened against data URL ReDoS with bounded linear scanning.
- Code scanning false positives were reviewed; remaining medium assistant error-boundary findings are deferred to a v0.2.2 cleanup.
Upgrade Notes
For Docker Compose users:
docker compose pull
docker compose up -dIf using an explicit image tag, use:
maxblack777/angemedia-gateway:v0.2.1
Known Notes
- Remaining CodeQL medium findings are assistant error-boundary diagnostics, not v0.2.1 release blockers.
- Multi-key provider pool / key rotation is not included in v0.2.1 and is deferred to a later version.
- Agnes Image remains an explicit experimental image channel, not the default stable image-to-image promise.
中文 · 版本卡片
版本: v0.2.1
发布类型: 稳定性、安全、Web Studio、队列运行时与发布卫生更新
推荐用户: 自托管用户、AI Agent 集成、NAS 部署、New API / OpenAI-compatible 媒体工作流
Git tag: v0.2.1
Docker 镜像: maxblack777/angemedia-gateway:v0.2.1
Latest 镜像: maxblack777/angemedia-gateway:latest
主要更新
- Web Studio 覆盖图片生成、视频生成、任务、资产、渠道、诊断、API 密钥和小助手设置。
- 图片和视频生成走队列优先架构,包含 dispatcher 和 worker 进程。
- Agnes Video v2.0 是当前发布版主视频路径。
- 明确 SiliconFlow/Kolors 是稳定图生图路径。
- 生成和上传媒体会本地化到受保护的
/generated/*和/uploads/*路径。 - 英文 README、中文 README、Skill 文档和更新日志已面向外部用户刷新。
- 发布打包卫生检查会排除已知内部审计、交接、发布报告、开发、设计 QA 和小助手执行计划文件。
- job/error 脱敏已将 data URL 正则替换为有长度上限的线性扫描,增强 ReDoS 防护。
- Code Scanning 误报已审查处理;剩余 medium 小助手错误边界项留到 v0.2.2 统一治理。
升级说明
Docker Compose 用户:
docker compose pull
docker compose up -d如果使用固定镜像 tag:
maxblack777/angemedia-gateway:v0.2.1
已知说明
- 剩余 CodeQL medium 是小助手错误边界/诊断类问题,不阻断 v0.2.1。
- 多 key 轮询、随机和失败切换不包含在 v0.2.1,后续版本再做。
- Agnes Image 是显式实验图片渠道,不作为默认稳定图生图承诺。
Changelog
Added
- Web Studio coverage for image generation, video generation, jobs, assets, channels, diagnostics, API keys, and assistant settings.
- Queue-first image and video generation with dispatcher and worker processes.
- Agnes Video v2.0 as the primary released video path.
- Protected local media import for generated and uploaded assets.
- Public README, Chinese README, and release notes for external users.
Changed
- Documented SiliconFlow/Kolors as the stable image-to-image path.
- Kept Agnes Image documented as an explicit image channel rather than a default stable image-to-image promise.
- Synced agent skill documentation with the public docs source.
- Tightened release packaging hygiene to block only named internal documents.
Security
- Release hygiene excludes known internal audit, handoff, release-report, development, design QA, and assistant execution-plan files.
- Documentation now consistently states that
/generated/*and/uploads/*are protected media paths. - Hardened job and error sanitization against data URL ReDoS by replacing regex-based data URL redaction with bounded linear scanning.
- Removed an insecure temporary-file test fixture reported by code scanning.
- Reviewed and dismissed confirmed CodeQL false positives with evidence; remaining medium assistant error-boundary items are deferred.
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 authenticatedHEAD.- 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.pyDocker
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