Add music-gen-api console script entrypoint for FastAPI server

Dockerfile

@@ -30,5 +30,5 @@ EXPOSE 8080
 ENV MUSIC_GEN_MODE=simulate
 ENV PORT=8080
 
-# Run the API server
-CMD uvicorn music_generator.api:app --host 0.0.0.0 --port ${PORT}
+# Run the API server using entrypoint
+CMD ["music-gen-api"]

README.md

@@ -80,10 +80,13 @@ music-gen generate \
 
 ```bash
 # Start the API server (binds to 0.0.0.0:8080 by default)
-uvicorn music_generator.api:app --host 0.0.0.0 --port 8080
+music-gen-api
 
 # Or set custom port
-PORT=3000 uvicorn music_generator.api:app --host 0.0.0.0 --port 3000
+PORT=3000 music-gen-api
+
+# Alternative: use uvicorn directly
+uvicorn music_generator.api:app --host 0.0.0.0 --port 8080
 ```
 
 Access API documentation at `http://localhost:8080/docs`
@@ -171,15 +174,18 @@ music-gen delete-preset my_metal
 
 ```bash
 # Default (simulate mode, no auth)
-uvicorn music_generator.api:app --host 0.0.0.0 --port 8080
+music-gen-api
 
 # With API key authentication
 export MUSIC_GEN_API_KEY=your-secret-key
-uvicorn music_generator.api:app --host 0.0.0.0 --port 8080
+music-gen-api
 
 # GCP mode
 export MUSIC_GEN_MODE=gcp
 export GOOGLE_CLOUD_PROJECT=your-project-id
+music-gen-api
+
+# Alternative: use uvicorn directly
 uvicorn music_generator.api:app --host 0.0.0.0 --port 8080
 ```
 
@@ -421,7 +427,7 @@ GitHub Codespaces works out of the box:
    ```
 4. Or start the API server:
    ```bash
-   uvicorn music_generator.api:app --host 0.0.0.0 --port 8080
+   music-gen-api
    ```
 
 ## Environment Variables

run-api.sh

@@ -32,4 +32,4 @@ echo ""
 echo "Press Ctrl+C to stop"
 echo ""
 
-uvicorn music_generator.api:app --host 0.0.0.0 --port $PORT
+music-gen-api

setup.py

@@ -27,6 +27,7 @@
     entry_points={
         "console_scripts": [
             "music-gen=music_generator.cli:main",
+            "music-gen-api=music_generator.api:main",
         ],
     },
     python_requires=">=3.9",

src/music_generator/api.py

@@ -5,6 +5,7 @@
 from fastapi import FastAPI, HTTPException, Header, Depends, Query
 from pydantic import BaseModel, Field
 import logging
+import uvicorn
 
 from .models import TrackConfig, SongStructure, StyleReference, PresetConfig
 from .generator import MusicGenerator
@@ -294,3 +295,23 @@ def health_check():
         "status": "healthy",
         "mode": os.getenv("MUSIC_GEN_MODE", "simulate")
     }
+
+
+def main():
+    """Main entrypoint for running the API server."""
+    # Read port from environment variable (for Cloud Run compatibility)
+    port = int(os.getenv("PORT", "8080"))
+
+    logger.info(f"Starting Music Track Generator API on port {port}")
+    logger.info(f"Mode: {os.getenv('MUSIC_GEN_MODE', 'simulate')}")
+
+    uvicorn.run(
+        app,
+        host="0.0.0.0",
+        port=port,
+        log_level="info"
+    )
+
+
+if __name__ == "__main__":
+    main()