musicflow-studioai 1.0.0__tar.gz

musicflow_studioai-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MusicFlow
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

musicflow_studioai-1.0.0/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: musicflow-studioai
+Version: 1.0.0
+Summary: AI adaptive game music & generation SDK for MusicFlow.
+Author-email: MusicFlow <hello@musicflow.io>
+License: MIT
+Project-URL: Homepage, https://musicflow.io
+Project-URL: Documentation, https://musicflow.io/dashboard/docs
+Keywords: music,ai,game,adaptive,soundtrack,musicflow,generation
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Multimedia :: Sound/Audio
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25
+Dynamic: license-file
+
+# musicflow-studioai (Python SDK)
+
+AI adaptive game music & generation for Python backends and tools.
+
+## Install
+```bash
+pip install musicflow-studioai
+# or from the downloaded archive:
+pip install ./musicflow-studioai.tar.gz
+```
+
+## Usage
+```python
+from musicflow import MusicFlow
+
+mf = MusicFlow("mf_live_xxx")
+
+# Generate and wait for completion
+track = mf.generate("epic boss battle", genre="Orchestral", duration=60, loop=True)
+print(track["audio_files"]["mp3"], track["metadata"]["bpm"])
+
+# Adaptive session
+mf.adaptive.create_session(game="Neon Drift", mood="dark")
+mf.adaptive.set_intensity(0.8)
+mf.adaptive.transition("boss")
+```
+
+## License
+MIT
+
+## Publishing (maintainers)
+```bash
+pip install build twine
+python -m build                       # builds dist/*.tar.gz and dist/*.whl
+twine check dist/*                    # validates metadata (should PASS)
+# 1) TestPyPI first (token from https://test.pypi.org/manage/account/token/)
+TWINE_USERNAME=__token__ TWINE_PASSWORD=pypi-... twine upload --repository testpypi dist/*
+pip install --index-url https://test.pypi.org/simple/ --no-deps musicflow-studioai
+# 2) then PyPI (token from https://pypi.org/manage/account/token/)
+TWINE_USERNAME=__token__ TWINE_PASSWORD=pypi-... twine upload dist/*
+```
+
+Docs: https://musicflow.io/dashboard/docs

musicflow_studioai-1.0.0/README.md

@@ -0,0 +1,43 @@
+# musicflow-studioai (Python SDK)
+
+AI adaptive game music & generation for Python backends and tools.
+
+## Install
+```bash
+pip install musicflow-studioai
+# or from the downloaded archive:
+pip install ./musicflow-studioai.tar.gz
+```
+
+## Usage
+```python
+from musicflow import MusicFlow
+
+mf = MusicFlow("mf_live_xxx")
+
+# Generate and wait for completion
+track = mf.generate("epic boss battle", genre="Orchestral", duration=60, loop=True)
+print(track["audio_files"]["mp3"], track["metadata"]["bpm"])
+
+# Adaptive session
+mf.adaptive.create_session(game="Neon Drift", mood="dark")
+mf.adaptive.set_intensity(0.8)
+mf.adaptive.transition("boss")
+```
+
+## License
+MIT
+
+## Publishing (maintainers)
+```bash
+pip install build twine
+python -m build                       # builds dist/*.tar.gz and dist/*.whl
+twine check dist/*                    # validates metadata (should PASS)
+# 1) TestPyPI first (token from https://test.pypi.org/manage/account/token/)
+TWINE_USERNAME=__token__ TWINE_PASSWORD=pypi-... twine upload --repository testpypi dist/*
+pip install --index-url https://test.pypi.org/simple/ --no-deps musicflow-studioai
+# 2) then PyPI (token from https://pypi.org/manage/account/token/)
+TWINE_USERNAME=__token__ TWINE_PASSWORD=pypi-... twine upload dist/*
+```
+
+Docs: https://musicflow.io/dashboard/docs

musicflow_studioai-1.0.0/musicflow/__init__.py

@@ -0,0 +1,74 @@
+"""MusicFlow Python SDK - client for the MusicFlow REST API."""
+import time
+import requests
+
+__version__ = "1.0.0"
+DEFAULT_BASE = "https://api.musicflow.io/v1"
+
+
+class MusicFlowError(Exception):
+    pass
+
+
+class Adaptive:
+    def __init__(self, client):
+        self._c = client
+        self.session_id = None
+
+    def create_session(self, game="Game", mood="cinematic"):
+        s = self._c._post("/adaptive/session", {"game_name": game, "mood": mood})
+        self.session_id = s["session_id"]
+        return s
+
+    def set_intensity(self, value):
+        return self._c._post("/adaptive/intensity", {"session_id": self.session_id, "intensity": value})
+
+    def transition(self, state):
+        return self._c._post("/adaptive/transition", {"session_id": self.session_id, "state": state})
+
+    def set_mood(self, mood):
+        return self._c._post("/adaptive/mood", {"session_id": self.session_id, "mood": mood})
+
+    def trigger_cue(self, name):
+        """Trigger a cutscene cue by name -> {cue, mood, genre, audio_url}."""
+        return self._c._post("/adaptive/cue", {"session_id": self.session_id, "name": name})
+
+
+class MusicFlow:
+    def __init__(self, api_key, base_url=DEFAULT_BASE):
+        if not api_key:
+            raise MusicFlowError("api_key is required")
+        self.api_key = api_key
+        self.base = base_url
+        self.adaptive = Adaptive(self)
+
+    def _headers(self):
+        return {"Authorization": f"Bearer {self.api_key}"}
+
+    def _post(self, path, body=None):
+        r = requests.post(self.base + path, json=body or {}, headers=self._headers(), timeout=30)
+        if not r.ok:
+            raise MusicFlowError(f"{path} -> {r.status_code}")
+        return r.json()
+
+    def _get(self, path):
+        r = requests.get(self.base + path, headers=self._headers(), timeout=30)
+        if not r.ok:
+            raise MusicFlowError(f"{path} -> {r.status_code}")
+        return r.json()
+
+    def generate(self, prompt, poll_seconds=4, timeout_seconds=300, **params):
+        """Generate a track and block until it is ready."""
+        created = self._post("/generations", {"prompt": prompt, **params})
+        start = time.time()
+        while time.time() - start < timeout_seconds:
+            g = self._get(f"/generations/{created['id']}")
+            if g["status"] == "completed":
+                return g
+            if g["status"] == "failed":
+                raise MusicFlowError("generation failed")
+            time.sleep(poll_seconds)
+        raise MusicFlowError("generation timed out")
+
+
+__all__ = ["MusicFlow", "Adaptive", "MusicFlowError", "__version__"]

musicflow_studioai-1.0.0/musicflow_studioai.egg-info/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: musicflow-studioai
+Version: 1.0.0
+Summary: AI adaptive game music & generation SDK for MusicFlow.
+Author-email: MusicFlow <hello@musicflow.io>
+License: MIT
+Project-URL: Homepage, https://musicflow.io
+Project-URL: Documentation, https://musicflow.io/dashboard/docs
+Keywords: music,ai,game,adaptive,soundtrack,musicflow,generation
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Multimedia :: Sound/Audio
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25
+Dynamic: license-file
+
+# musicflow-studioai (Python SDK)
+
+AI adaptive game music & generation for Python backends and tools.
+
+## Install
+```bash
+pip install musicflow-studioai
+# or from the downloaded archive:
+pip install ./musicflow-studioai.tar.gz
+```
+
+## Usage
+```python
+from musicflow import MusicFlow
+
+mf = MusicFlow("mf_live_xxx")
+
+# Generate and wait for completion
+track = mf.generate("epic boss battle", genre="Orchestral", duration=60, loop=True)
+print(track["audio_files"]["mp3"], track["metadata"]["bpm"])
+
+# Adaptive session
+mf.adaptive.create_session(game="Neon Drift", mood="dark")
+mf.adaptive.set_intensity(0.8)
+mf.adaptive.transition("boss")
+```
+
+## License
+MIT
+
+## Publishing (maintainers)
+```bash
+pip install build twine
+python -m build                       # builds dist/*.tar.gz and dist/*.whl
+twine check dist/*                    # validates metadata (should PASS)
+# 1) TestPyPI first (token from https://test.pypi.org/manage/account/token/)
+TWINE_USERNAME=__token__ TWINE_PASSWORD=pypi-... twine upload --repository testpypi dist/*
+pip install --index-url https://test.pypi.org/simple/ --no-deps musicflow-studioai
+# 2) then PyPI (token from https://pypi.org/manage/account/token/)
+TWINE_USERNAME=__token__ TWINE_PASSWORD=pypi-... twine upload dist/*
+```
+
+Docs: https://musicflow.io/dashboard/docs

musicflow_studioai-1.0.0/musicflow_studioai.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+LICENSE
+README.md
+pyproject.toml
+musicflow/__init__.py
+musicflow_studioai.egg-info/PKG-INFO
+musicflow_studioai.egg-info/SOURCES.txt
+musicflow_studioai.egg-info/dependency_links.txt
+musicflow_studioai.egg-info/requires.txt
+musicflow_studioai.egg-info/top_level.txt

musicflow_studioai-1.0.0/musicflow_studioai.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

musicflow_studioai-1.0.0/musicflow_studioai.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.25

musicflow_studioai-1.0.0/musicflow_studioai.egg-info/top_level.txt

@@ -0,0 +1 @@
+musicflow

musicflow_studioai-1.0.0/pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["setuptools>=61", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "musicflow-studioai"
+version = "1.0.0"
+description = "AI adaptive game music & generation SDK for MusicFlow."
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [{ name = "MusicFlow", email = "hello@musicflow.io" }]
+keywords = ["music", "ai", "game", "adaptive", "soundtrack", "musicflow", "generation"]
+dependencies = ["requests>=2.25"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.8",
+  "Programming Language :: Python :: 3.11",
+  "Topic :: Multimedia :: Sound/Audio",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+[project.urls]
+Homepage = "https://musicflow.io"
+Documentation = "https://musicflow.io/dashboard/docs"
+
+[tool.setuptools]
+packages = ["musicflow"]

musicflow_studioai-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+