Start using AngeMedia Gateway
Validate one provider and one successful job before adding more models, video workflows or agent integrations.
Before you start
- Install Docker and Docker Compose V2, or Python 3.10+ with virtual environments.
- Prepare one working image-provider API key. Video generation requires a supported video provider.
- Reserve persistent storage for the database, uploads and generated media.
Start with Docker Compose
git clone https://github.com/AngeVox/AngeMedia-gateway.git
cd AngeMedia-gateway
export ADMIN_USERNAME=admin
export ADMIN_DEFAULT_PASSWORD='replace-with-a-long-random-password'
export GATEWAY_API_KEY='replace-with-a-long-random-gateway-key'
docker compose up -d --build
The current Compose Web Studio entry is:
http://localhost:9892/studio
Run locally with Python
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.lock
export ADMIN_USERNAME=admin
export ADMIN_DEFAULT_PASSWORD='replace-with-a-long-random-password'
python -m uvicorn scripts.angemedia_gateway.server:app --host 127.0.0.1 --port 9890
The Python path is useful for development and troubleshooting. Prefer the verified Compose configuration for long-running deployments.
First sign-in
- Open Web Studio.
- Sign in with the administrator credentials configured before startup.
- Open the provider page and configure only one provider first.
- Run the connection test and verify the key and Base URL.
Check health
curl http://127.0.0.1:9890/health
Compose may map a different host port. Use the port from the actual deployment.
Generate the first image
curl -X POST http://127.0.0.1:9890/v1/images/generations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_GATEWAY_KEY" \
-d '{"prompt":"a calm product photo on a clean desk","size":"1024x1024","response_format":"url"}'
Confirm that the returned or localized media can be opened before configuring image editing or video jobs.
Next steps
- Use the interface: Web Studio.
- Add providers and models: Providers and models.
- Call the API: API examples.
- Before sharing the service: Security.