Tiny Anthems

Tiny Anthems is a Django-template private beta app for selling credits and generating short personalized songs.

Local Setup

python3 -m venv .venv
. .venv/bin/activate
pip install -r requirements.txt
python manage.py migrate --run-syncdb
python manage.py createsuperuser
python manage.py runserver

For local testing, SQLite is used by default. Configure Stripe price IDs and webhooks with the variables in .env.example before running checkout against Stripe test mode.

Docker Compose Setup

Start the app stack:

docker compose up --build

The app runs at http://localhost:8000 with:

• Django web server
• Celery worker
• Postgres
• Redis

By default, Docker is configured for the real ElevenLabs provider. Copy the template and add local secrets:

cp .env.docker.example .env.docker

Edit .env.docker:

DEFAULT_MUSIC_PROVIDER=elevenlabs
ELEVENLABS_API_KEY=replace-with-real-key
CELERY_TASK_ALWAYS_EAGER=false

Then restart:

docker compose --env-file .env.docker up --build

Never commit .env.docker; it is ignored by Git.

GCS Audio Storage

Local development defaults to filesystem storage in media/. For beta/staging, use Google Cloud Storage so generated songs do not accumulate inside the app container:

STORAGE_BACKEND=gcs
GCS_BUCKET_NAME=tiny-anthems-audio
GCS_PROJECT_ID=your-gcp-project-id
GCS_SIGNED_URL_TTL_SECONDS=900
GOOGLE_APPLICATION_CREDENTIALS=/run/secrets/gcp-service-account.json

Keep the service account JSON outside Git at secrets/gcp-service-account.json, then start Docker Compose with the GCS override:

docker compose --env-file .env.docker -f docker-compose.yml -f docker-compose.gcs.yml up --build

The app stores private object keys in the database and serves downloads through short-lived signed URLs after validating the song or share token.

Background Jobs

Generation is queued through Celery. Local development defaults to eager execution so a separate worker is not required:

CELERY_TASK_ALWAYS_EAGER=true

For production-like async behavior, run Redis and set CELERY_TASK_ALWAYS_EAGER=false, then start a worker:

celery -A config worker -l info

Authentication

Email sign-in uses single-use magic links. In local development, Django prints those emails to the web process logs:

docker compose --env-file .env.docker -f docker-compose.yml -f docker-compose.gcs.yml logs -f web

Google OAuth is enabled when these values are configured:

GOOGLE_OAUTH_CLIENT_ID=replace-with-google-client-id
GOOGLE_OAUTH_CLIENT_SECRET=replace-with-google-client-secret
GOOGLE_OAUTH_REDIRECT_URI=http://localhost:8000/accounts/google/callback/

Render Deployment

This repo includes a Render blueprint in render.yaml based on Render's Django deployment guide. The blueprint creates:

• Django web service
• Postgres database

For a low-cost beta deploy, Render runs generation eagerly in the web service with CELERY_TASK_ALWAYS_EAGER=true. Migrations run in build.sh because free web services do not support pre-deploy commands. Add Redis and a separate worker later when traffic justifies the extra monthly cost.

After creating the blueprint in Render, set these secrets/env vars on the web service:

APP_BASE_URL=https://tiny-anthems-web.onrender.com
ALLOWED_HOSTS=tiny-anthems-web.onrender.com
DEFAULT_FROM_EMAIL=Tiny Anthems <hello@yourdomain.com>
EMAIL_BACKEND=django.core.mail.backends.smtp.EmailBackend
EMAIL_HOST=your-email-host
EMAIL_PORT=587
EMAIL_HOST_USER=your-email-user
EMAIL_HOST_PASSWORD=your-email-password
EMAIL_USE_TLS=true
GCS_BUCKET_NAME=tiny-anthems-prod
GCS_PROJECT_ID=your-gcp-project-id
GCS_SERVICE_ACCOUNT_JSON={"type":"service_account",...}
GOOGLE_OAUTH_CLIENT_ID=replace-with-google-client-id
GOOGLE_OAUTH_CLIENT_SECRET=replace-with-google-client-secret
GOOGLE_OAUTH_REDIRECT_URI=https://tiny-anthems-web.onrender.com/accounts/google/callback/
STRIPE_SECRET_KEY=replace-with-stripe-secret-key
STRIPE_WEBHOOK_SECRET=replace-with-stripe-webhook-secret
ELEVENLABS_API_KEY=replace-with-real-key

The web service also needs the Stripe credit pack price IDs:

STRIPE_PRICE_ID_CREDITS_1=price_...
STRIPE_PRICE_ID_CREDITS_2=price_...
STRIPE_PRICE_ID_CREDITS_3=price_...
STRIPE_PRICE_ID_CREDITS_4=price_...
STRIPE_PRICE_ID_CREDITS_5=price_...

Add the Render callback URL to Google OAuth and point Stripe webhooks at:

https://tiny-anthems-web.onrender.com/api/stripe/webhook/

Music Generation

Tiny Anthems defaults to ElevenLabs for generation. To call ElevenLabs in a beta/staging environment, set:

DEFAULT_MUSIC_PROVIDER=elevenlabs
ELEVENLABS_API_KEY=replace-with-real-key
ELEVENLABS_MODEL_ID=music_v1
ELEVENLABS_OUTPUT_FORMAT=mp3_44100_128
ELEVENLABS_TIMEOUT_SECONDS=180
ELEVENLABS_USE_COMPOSITION_PLAN=false

ELEVENLABS_USE_COMPOSITION_PLAN=true will first call /v1/music/plan, then submit that plan to /v1/music. Leave it off for the simplest prompt-to-song path.

There is still a mock provider for automated tests and local development only. It is disabled unless explicitly enabled:

ALLOW_MOCK_MUSIC_PROVIDER=true
DEFAULT_MUSIC_PROVIDER=mock