How azaken1248/osurenderapi works
OsuRender accepts osu! replay submissions, validates and stores them, records a render job plus an outbox event, then dispatches work for rendering and exposes status, artifacts, and replay analytics. The worker prepares replay metadata and delegates video generation to the render pipeline, which uses cloud or local GPU execution and object storage. The README also identifies skins, legacy endpoints, and Modal as product capabilities. Dispatcher and several route/worker details are represented from the SOURCE INDEX; their internal behavior was not fully excerpted.
Main entry points: app.py FastAPI gateway · render_worker.py Render worker · models.py Jobs and outbox · render.py Render submission
Components 20
API and access
- FastAPI gateway
src/api/app.py - Render submission
src/api/routes/render.py - Job status and analytics
src/api/routes/jobs.py - Legacy endpoints
src/api/routes/legacy.py - Skin management
src/api/routes/skins.py - Artifact access
src/api/routes/artifacts.py - Web replay player
src/api/routes/view.py
Job orchestration
- Outbox dispatcher
src/workers/dispatcher.py - Celery queue
Render execution
- Render worker
src/workers/render_worker.py - Replay render pipeline
src/core/render_pipeline.py - Modal GPU execution
src/modal_deploy.py
Data and operations
- Jobs and outbox
src/db/models.py - Storage client
src/core/storage.py - Prometheus metrics
src/core/metrics.py - Service configuration
src/core/config.py
Other components
- API client
- Object storage
- Danser-Go
- osu! API
Connections 27
- API client → FastAPI gateway: sends requests
src/api/app.py - FastAPI gateway → Render submission: routes requests
src/api/app.py - FastAPI gateway → Job status and analytics: routes requests
src/api/app.py - FastAPI gateway → Legacy endpoints: routes requests
src/api/app.py - FastAPI gateway → Skin management: routes requests
src/api/app.py - FastAPI gateway → Artifact access: routes requests
src/api/app.py - FastAPI gateway → Web replay player: routes requests
src/api/app.py - Render submission → Storage client: uploads replay
src/api/routes/render.py - Render submission → Jobs and outbox: stores job and event
src/api/routes/render.py - Job status and analytics → Jobs and outbox: reads job state
src/api/routes/jobs.py - Legacy endpoints → Jobs and outbox: reads job data
src/api/routes/legacy.py - Web replay player → Jobs and outbox: reads job data
src/api/routes/view.py - Skin management → Storage client: manages skin objects
src/api/routes/skins.py - Artifact access → Storage client: reads stored artifacts
src/api/routes/artifacts.py - Storage client → Object storage: stores objects
src/core/storage.py - Outbox dispatcher → Render worker: dispatches render task
src/workers/dispatcher.py - Outbox dispatcher → Celery queue: queues tasks
- Render worker → Jobs and outbox: updates job state
src/workers/render_worker.py - Render worker → osu! API: fetches score data
src/workers/render_worker.py - Render worker → Replay render pipeline: executes render pipeline
src/workers/render_worker.py - Replay render pipeline → Object storage: downloads and uploads
src/core/render_pipeline.py - Replay render pipeline → Danser-Go: runs renderer
src/core/render_pipeline.py - Render worker → Modal GPU execution: uses GPU execution
- FastAPI gateway → Prometheus metrics: publishes metrics
src/api/app.py - Render submission → Prometheus metrics: counts submissions
src/api/routes/render.py - Job status and analytics → Prometheus metrics: counts analytics requests
src/api/routes/jobs.py - FastAPI gateway → Service configuration: loads settings
src/api/app.py