3dtours/K.G.One
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: integrate KGStudio DAW, soundfonts, and add project license

Browse Source
This commit is contained in:
Xiaohan-Tian
2026-04-17 16:51:49 -07:00
parent 8659e0b76b
commit c4bb645003
7 changed files with 486 additions and 14 deletions
Download Patch File Download Diff File Expand all files Collapse all files
LICENSE
+237
View File
@@ -0,0 +1,237 @@
Apache License
Version 2.0, January 2004
http://www.apache.org/licenses/
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
1. Definitions.
"License" shall mean the terms and conditions for use, reproduction,
and distribution as defined by Sections 1 through 9 of this document.
"Licensor" shall mean the copyright owner or entity authorized by
the copyright owner that is granting the License.
"Legal Entity" shall mean the union of the acting entity and all
other entities that control, are controlled by, or are under common
control with that entity. For the purposes of this definition,
"control" means (i) the power, direct or indirect, to cause the
direction or management of such entity, whether by contract or
otherwise, or (ii) ownership of fifty percent (50%) or more of the
outstanding shares, or (iii) beneficial ownership of such entity.
"You" (or "Your") shall mean an individual or Legal Entity
exercising permissions granted by this License.
"Source" form shall mean the preferred form for making modifications,
including but not limited to software source code, documentation
source, and configuration files.
"Object" form shall mean any form resulting from mechanical
transformation or translation of a Source form, including but
not limited to compiled object code, generated documentation,
and conversions to other media types.
"Work" shall mean the work of authorship made available under
the License, as indicated by a copyright notice that is included in
or attached to the work (an example is provided in the Appendix below).
"Derivative Works" shall mean any work, whether in Source or Object
form, that is based on (or derived from) the Work and for which the
editorial revisions, annotations, elaborations, or other modifications
represent, as a whole, an original work of authorship. For the purposes
of this License, Derivative Works shall not include works that remain
separable from, or merely link (or bind by name) to the interfaces of,
the Work and Derivative Works thereof.
"Contribution" shall mean, as submitted to the Licensor for inclusion
in the Work by the copyright owner or by an individual or Legal Entity
authorized to submit on behalf of the copyright owner. For the purposes
of this definition, "submitted" means any form of electronic, verbal,
or written communication sent to the Licensor or its representatives,
including but not limited to communication on electronic mailing lists,
source code control systems, and issue tracking systems that are managed
by, or on behalf of, the Licensor for the purpose of discussing and
improving the Work, but excluding communication that is conspicuously
marked or designated in writing by the copyright owner as "Not a
Contribution."
"Contributor" shall mean Licensor and any Legal Entity on behalf of
whom a Contribution has been received by the Licensor and subsequently
incorporated within the Work.
2. Grant of Copyright License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
copyright license to reproduce, prepare Derivative Works of,
publicly display, publicly perform, sublicense, and distribute the
Work and such Derivative Works in Source or Object form.
3. Grant of Patent License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
(except as stated in this section) patent license to make, have made,
use, offer to sell, sell, import, and otherwise transfer the Work,
where such license applies only to those patent claims licensable
by such Contributor that are necessarily infringed by their
Contribution(s) alone or by combination of their Contribution(s)
with the Work to which such Contribution(s) was submitted. If You
institute patent litigation against any entity (including a cross-claim
or counterclaim in a lawsuit) alleging that the Work or a Contribution
incorporated within the Work constitutes direct or contributory patent
infringement, then any patent licenses granted to You under this License
for that Work shall terminate as of the date such litigation is filed.
4. Redistribution. You may reproduce and distribute copies of the
Work or Derivative Works thereof in any medium, with or without
modifications, and in Source or Object form, provided that You
meet the following conditions:
(a) You must give any other recipients of the Work or
Derivative Works a copy of this License; and
(b) You must cause any modified files to carry prominent notices
stating that You changed the files; and
(c) You must retain, in the Source form of any Derivative Works
that You distribute, all copyright, patent, trademark, and
attribution notices from the Source form of the Work,
excluding those notices that do not pertain to any part of
the Derivative Works; and
(d) If the Work includes a "NOTICE" text file as part of its
distribution, You must include a readable copy of the
attribution notices contained within such NOTICE file, in
at least one of the following places: within a NOTICE text
file distributed as part of the Derivative Works; within
the Source form or documentation, if provided along with the
Derivative Works; or, within a display generated by the
Derivative Works, if and wherever such third-party notices
normally appear. The contents of the NOTICE file are for
informational purposes only and do not modify the License.
You may add Your own attribution notices within Derivative
Works that You distribute, alongside or as an addendum to
the NOTICE text from the Work, provided that such additional
attribution notices cannot be construed as modifying the License.
You may add Your own license statement for Your modifications and
may provide additional grant of rights to use, copy, modify, merge,
publish, distribute, sublicense, and/or sell copies of Your
modifications, and to permit persons to whom Your modifications are
furnished to do so.
5. Submission of Contributions. Unless You explicitly state otherwise,
any Contribution intentionally submitted for inclusion in the Work
by You to the Licensor shall be under the terms and conditions of
this License, without any additional terms or conditions.
Notwithstanding the above, nothing herein shall supersede or modify
the terms of any separate license agreement you may have executed
with Licensor regarding such Contributions.
6. Trademarks. This License does not grant permission to use the trade
names, trademarks, service marks, or product names of the Licensor,
except as required for reasonable and customary use in describing the
origin of the Work and reproducing the content of the NOTICE file.
7. Disclaimer of Warranty. Unless required by applicable law or
agreed to in writing, Licensor provides the Work (and each
Contributor provides its Contributions) on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied, including, without limitation, any warranties or conditions
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
PARTICULAR PURPOSE. You are solely responsible for determining the
appropriateness of using or redistributing the Work and assume any
risks associated with Your exercise of permissions under this License.
8. Limitation of Liability. In no event and under no legal theory,
whether in tort (including negligence), contract, or otherwise,
unless required by applicable law (such as deliberate and grossly
negligent acts) or agreed to in writing, shall any Contributor be
liable to You for damages, including any direct, indirect, special,
incidental, or exemplary damages of any character arising as a
result of this License or out of the use or inability to use the
Work (including but not limited to damages for loss of goodwill,
work stoppage, computer failure or malfunction, or all other
commercial damages or losses), even if such Contributor has been
advised of the possibility of such damages.
9. Accepting Warranty or Liability. While redistributing the Work or
Derivative Works thereof, You may choose to offer, and charge a fee
for, acceptance of support, warranty, indemnity, or other liability
obligations and rights consistent with this License. However, in
accepting such obligations, You may offer such obligations only on
Your own behalf and on Your sole responsibility, not on behalf of
any other Contributor, and only if You agree to indemnify, defend,
and hold each Contributor harmless for any liability incurred by,
or claims asserted against, such Contributor by reason of your
accepting any such warranty or additional liability.
END OF TERMS AND CONDITIONS
---
SUPPLEMENTAL TERMS (additional conditions under Section 4)
The following supplemental terms apply to all use, reproduction, and
distribution of this Work:
a. Patent Prohibition. You may not use this software, its source code,
its compiled forms, its documentation, or any assets associated with
it to file or assist in filing any patent application of any kind in
any jurisdiction.
b. Attribution Requirement. Any public or commercial deployment,
distribution, or product that incorporates this Work or a Derivative
Work must display the following notice in a prominent location visible
to end users (such as a splash screen, about page, or footer):
Powered by K.G.One © 2026 Xiaohan Tian
---
THIRD-PARTY COMPONENT NOTICES
K.G.One integrates or proxies the following third-party projects. Their
respective licenses govern your use of those components.
1. K.G.Studio (https://github.com/KGAudioLab/K.G.Studio)
Apache License 2.0 with supplemental terms:
- You may not use the software to file or support any patent application.
- Public or commercial use requires displaying:
"Powered by K.G.Studio © 2025 Xiaohan Tian"
Full license: https://github.com/KGAudioLab/K.G.Studio/blob/main/LICENSE
2. ACE-Step 1.5 (https://github.com/ace-step/ACE-Step-1.5)
MIT License
Full license: https://github.com/ace-step/ACE-Step-1.5/blob/main/LICENSE
3. Foundation-1 / stable-audio-open-1.0
(https://huggingface.co/stabilityai/stable-audio-open-1.0)
Stability AI Community License
- Free for research and non-commercial use.
- Commercial use requires a separate license from Stability AI.
See: https://stability.ai/license
Full license: https://huggingface.co/stabilityai/stable-audio-open-1.0
4. python-audio-separator / UVR5 (https://github.com/nomadkaraoke/python-audio-separator)
MIT License
Full license: https://github.com/nomadkaraoke/python-audio-separator/blob/main/LICENSE
If you use features powered by any of the above components, you are
responsible for complying with their respective licenses.
---
Copyright 2026 Xiaohan Tian
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
README.md
+24
View File
@@ -631,3 +631,27 @@ curl -X POST http://localhost:8000/v1/models/load \
}
}
```
---
## License
K.G.One is licensed under the [Apache License 2.0](./LICENSE) with two supplemental conditions:
- **No patents** — this software may not be used to file or support any patent application in any jurisdiction.
- **Attribution** — public or commercial deployments must display `Powered by K.G.One © 2026 Xiaohan Tian` in a prominent location visible to end users.
### Third-party component licenses
K.G.One integrates or proxies the following projects. If you use the corresponding features, you are responsible for complying with their licenses.
| Component | Used for | License | Notes |
|-----------|----------|---------|-------|
| [K.G.Studio](https://github.com/KGAudioLab/K.G.Studio) | Browser DAW UI | Apache 2.0 + custom terms | Public/commercial use requires displaying `Powered by K.G.Studio © 2025 Xiaohan Tian`; no patent filing permitted |
| [ACE-Step 1.5](https://github.com/ace-step/ACE-Step-1.5) | Full-song generation (`/v1/fullsong/*`) | MIT | Permissive — attribution required |
| [stable-audio-open-1.0](https://huggingface.co/stabilityai/stable-audio-open-1.0) | Clip generation (`/v1/clip/*`) via Foundation-1 | Stability AI Community License | **Non-commercial only.** Commercial use requires a separate license from Stability AI — see [stability.ai/license](https://stability.ai/license) |
| [python-audio-separator / UVR5](https://github.com/nomadkaraoke/python-audio-separator) | Stem separation (`/v1/separator/*`) | MIT | Permissive — attribution required |
> **Note:** The `clip` generation feature is powered by a model released under the Stability AI Community License, which **does not permit commercial use**. If you intend to use K.G.One in a commercial product, you must obtain a commercial license from Stability AI before enabling or exposing the `/v1/clip/*` endpoints.
See [LICENSE](./LICENSE) for the full terms including third-party notices.
cleanup.bat
+18
View File
@@ -10,6 +10,8 @@ echo .venv\ (gateway Python environment)
echo ace-step\ (submodule + venv + model checkpoints)
echo foundation1\ (submodule + venv + model weights)
echo separator\ (submodule + venv)
echo kgstudio\ (frontend repo + node_modules + dist)
echo soundfonts\ (soundfont-for-samplers MP3 samples, ~150 MB)
echo outputs\ (all generated audio and MIDI files)
echo uploads\ (all uploaded audio files)
echo.
@@ -55,6 +57,22 @@ if exist "separator" (
echo separator not found, skipping.
)
if exist "kgstudio" (
echo Removing kgstudio ...
rmdir /s /q "kgstudio"
echo Done.
) else (
echo kgstudio not found, skipping.
)
if exist "soundfonts" (
echo Removing soundfonts ...
rmdir /s /q "soundfonts"
echo Done.
) else (
echo soundfonts not found, skipping.
)
if exist "outputs" (
echo Removing outputs ...
rmdir /s /q "outputs"
init.bat
+130 -12
View File
@@ -23,12 +23,19 @@ if errorlevel 1 (
exit /b 1
)
where nvm >nul 2>&1
if errorlevel 1 (
echo ERROR: nvm not found. Install from https://github.com/coreybutler/nvm-windows/releases
exit /b 1
)
echo git ... OK
echo uv ... OK
echo nvm ... OK
echo.
:: ---------------------------------------------------------
echo [1/6] Reading submodules.json...
echo [1/9] Reading submodules.json...
:: ---------------------------------------------------------
powershell -NoProfile -Command "$j = Get-Content 'submodules.json' | ConvertFrom-Json; $j.'ace-step'.url | Out-File -Encoding ASCII '%TEMP%\kg_acestep_url.txt' -NoNewline"
@@ -41,6 +48,9 @@ powershell -NoProfile -Command "$j = Get-Content 'submodules.json' | ConvertFrom
powershell -NoProfile -Command "$j = Get-Content 'submodules.json' | ConvertFrom-Json; $j.foundation1.commit | Out-File -Encoding ASCII '%TEMP%\kg_f1_commit.txt' -NoNewline"
powershell -NoProfile -Command "$j = Get-Content 'submodules.json' | ConvertFrom-Json; $j.'python-audio-separator'.url | Out-File -Encoding ASCII '%TEMP%\kg_sep_url.txt' -NoNewline"
powershell -NoProfile -Command "$j = Get-Content 'submodules.json' | ConvertFrom-Json; $j.'python-audio-separator'.commit | Out-File -Encoding ASCII '%TEMP%\kg_sep_commit.txt' -NoNewline"
powershell -NoProfile -Command "$j = Get-Content 'submodules.json' | ConvertFrom-Json; $j.kgstudio.url | Out-File -Encoding ASCII '%TEMP%\kg_kgs_url.txt' -NoNewline"
powershell -NoProfile -Command "$j = Get-Content 'submodules.json' | ConvertFrom-Json; $j.'soundfont-for-samplers'.url | Out-File -Encoding ASCII '%TEMP%\kg_sf_url.txt' -NoNewline"
powershell -NoProfile -Command "$j = Get-Content 'submodules.json' | ConvertFrom-Json; $j.'soundfont-for-samplers'.commit | Out-File -Encoding ASCII '%TEMP%\kg_sf_commit.txt' -NoNewline"
set /p ACESTEP_URL=<"%TEMP%\kg_acestep_url.txt"
set /p ACESTEP_COMMIT=<"%TEMP%\kg_acestep_commit.txt"
@@ -48,7 +58,10 @@ set /p FOUNDATION1_URL=<"%TEMP%\kg_f1_url.txt"
set /p FOUNDATION1_COMMIT=<"%TEMP%\kg_f1_commit.txt"
set /p SEP_URL=<"%TEMP%\kg_sep_url.txt"
set /p SEP_COMMIT=<"%TEMP%\kg_sep_commit.txt"
del "%TEMP%\kg_acestep_url.txt" "%TEMP%\kg_acestep_commit.txt" "%TEMP%\kg_f1_url.txt" "%TEMP%\kg_f1_commit.txt" "%TEMP%\kg_sep_url.txt" "%TEMP%\kg_sep_commit.txt" >nul 2>&1
set /p KGSTUDIO_URL=<"%TEMP%\kg_kgs_url.txt"
set /p SOUNDFONTS_URL=<"%TEMP%\kg_sf_url.txt"
set /p SOUNDFONTS_COMMIT=<"%TEMP%\kg_sf_commit.txt"
del "%TEMP%\kg_acestep_url.txt" "%TEMP%\kg_acestep_commit.txt" "%TEMP%\kg_f1_url.txt" "%TEMP%\kg_f1_commit.txt" "%TEMP%\kg_sep_url.txt" "%TEMP%\kg_sep_commit.txt" "%TEMP%\kg_kgs_url.txt" "%TEMP%\kg_sf_url.txt" "%TEMP%\kg_sf_commit.txt" >nul 2>&1
if "%ACESTEP_URL%"=="" (
echo ERROR: Could not read from submodules.json
@@ -61,10 +74,13 @@ echo Foundation-1 URL : %FOUNDATION1_URL%
echo Foundation-1 commit: %FOUNDATION1_COMMIT%
echo audio-separator URL : %SEP_URL%
echo audio-separator commit: %SEP_COMMIT%
echo KGStudio URL : %KGSTUDIO_URL%
echo soundfont-for-samplers URL : %SOUNDFONTS_URL%
echo soundfont-for-samplers commit: %SOUNDFONTS_COMMIT%
echo.
:: ---------------------------------------------------------
echo [2/6] Setting up ACE-Step...
echo [2/9] Setting up ACE-Step...
:: ---------------------------------------------------------
if exist "ace-step\.git" goto :acestep_fetch
@@ -91,7 +107,7 @@ echo ACE-Step OK.
echo.
:: ---------------------------------------------------------
echo [3/6] Setting up Foundation-1...
echo [3/9] Setting up Foundation-1...
:: ---------------------------------------------------------
if exist "foundation1\.git" goto :f1_fetch
@@ -118,7 +134,7 @@ echo Foundation-1 OK.
echo.
:: ---------------------------------------------------------
echo Setting up python-audio-separator...
echo [4/9] Setting up python-audio-separator...
:: ---------------------------------------------------------
if exist "separator\.git" goto :sep_fetch
@@ -145,7 +161,102 @@ echo python-audio-separator OK.
echo.
:: ---------------------------------------------------------
echo [4/6] Setting up Python environments...
echo [5/9] Setting up KGStudio...
:: ---------------------------------------------------------
if exist "kgstudio\.git" goto :kgstudio_pull
echo Cloning KGStudio...
git clone "%KGSTUDIO_URL%" kgstudio
if errorlevel 1 (
echo ERROR: Failed to clone KGStudio
exit /b 1
)
goto :kgstudio_node
:kgstudio_pull
echo Repository exists. Pulling latest...
git -C kgstudio pull --quiet origin
:kgstudio_node
echo Installing Node.js 20.19 (latest patch)...
nvm install 20.19
if errorlevel 1 (
echo ERROR: Failed to install Node.js 20.19
exit /b 1
)
nvm use 20.19
if errorlevel 1 (
echo ERROR: Failed to activate Node.js 20.19
exit /b 1
)
:: nvm use updates the symlink but does not update PATH in the current batch session.
:: Resolve node's directory from nvm root + nvm current and inject it into PATH.
for /f "usebackq delims=" %%R in (`nvm root`) do set "_NVM_ROOT=%%R"
for /f "usebackq delims=" %%V in (`nvm current`) do set "_NVM_VER=%%V"
set "PATH=%_NVM_ROOT%\%_NVM_VER%;%PATH%"
echo Installing npm dependencies...
pushd kgstudio
echo kgstudio_npm_install_start > "%TEMP%\kginit_trace.txt"
call npm install --no-audit --no-fund
set "_EC=%ERRORLEVEL%"
echo kgstudio_npm_install_exit_%_EC% >> "%TEMP%\kginit_trace.txt"
echo [debug] npm install exit code: %_EC%
if %_EC% neq 0 (
popd
type "%TEMP%\kginit_trace.txt"
echo ERROR: npm install failed ^(exit code %_EC%^)
exit /b 1
)
echo Building KGStudio (tsc + vite build)...
echo kgstudio_npm_build_start >> "%TEMP%\kginit_trace.txt"
call npm run build
set "_EC=%ERRORLEVEL%"
echo kgstudio_npm_build_exit_%_EC% >> "%TEMP%\kginit_trace.txt"
echo [debug] npm run build exit code: %_EC%
if %_EC% neq 0 (
popd
type "%TEMP%\kginit_trace.txt"
echo ERROR: npm run build failed ^(exit code %_EC%^)
exit /b 1
)
popd
del "%TEMP%\kginit_trace.txt" >nul 2>&1
if not exist "kgstudio\dist\index.html" (
echo ERROR: Build succeeded but dist\index.html not found
exit /b 1
)
echo KGStudio OK.
echo.
:: ---------------------------------------------------------
echo [6/9] Setting up soundfonts...
:: ---------------------------------------------------------
if exist "soundfonts\.git" goto :soundfonts_fetch
echo Cloning soundfont-for-samplers (may take several minutes, ~150 MB)...
git clone "%SOUNDFONTS_URL%" soundfonts
if errorlevel 1 (
echo ERROR: Failed to clone soundfont-for-samplers
exit /b 1
)
goto :soundfonts_checkout
:soundfonts_fetch
echo Repository exists. Fetching refs...
git -C soundfonts fetch --quiet origin
:soundfonts_checkout
echo Checking out pinned commit %SOUNDFONTS_COMMIT%...
git -C soundfonts checkout %SOUNDFONTS_COMMIT% --quiet
if errorlevel 1 (
echo ERROR: Could not checkout soundfont-for-samplers commit %SOUNDFONTS_COMMIT%
exit /b 1
)
echo soundfont-for-samplers OK.
echo.
:: ---------------------------------------------------------
echo [7/9] Setting up Python environments...
:: ---------------------------------------------------------
:: Gateway venv
@@ -273,7 +384,7 @@ echo Separator venv already exists, skipping.
echo.
:: ---------------------------------------------------------
echo [5/6] Creating output directories...
echo [8/9] Creating output directories...
:: ---------------------------------------------------------
if not exist "outputs\clip" mkdir "outputs\clip"
if not exist "outputs\fullsong" mkdir "outputs\fullsong"
@@ -285,7 +396,7 @@ echo Done.
echo.
:: ---------------------------------------------------------
echo [6/6] Downloading model weights...
echo [9/9] Downloading model weights...
:: ---------------------------------------------------------
:: ACE-Step weights - mirrors what the API server does on first initialize:
@@ -324,16 +435,23 @@ echo Initialization complete!
echo ==========================================
echo.
echo Start the gateway:
echo .venv\Scripts\python.exe main.py
echo uv run .\main.py
echo uv run .\main.py --host 0.0.0.0 (allow remote access)
echo uv run .\main.py --host 0.0.0.0 --port 8080 (custom port)
echo.
echo The default browser will open automatically once the server starts.
echo.
echo Then load a model:
echo POST http://localhost:8000/v1/models/load
echo POST http://127.0.0.1:8000/v1/models/load
echo Body: {"model": "clip"} -- Foundation-1 (MIDI + WAV)
echo Body: {"model": "fullsong"} -- ACE-Step 1.5 (full songs)
echo.
echo Or separate stems (no model load needed):
echo POST http://localhost:8000/v1/separator/separate
echo POST http://127.0.0.1:8000/v1/separator/separate
echo Body: multipart/form-data file=<audio> model_filename=<model>
echo.
echo API docs: http://localhost:8000/docs
echo K.G.Studio DAW:
echo http://127.0.0.1:8000 (redirects to /kgstudio/)
echo.
echo API docs: http://127.0.0.1:8000/docs
echo.
kgone-server.json
+4
View File
@@ -0,0 +1,4 @@
{
"base_url": "http://127.0.0.1:{port}",
"soundfont": "http://127.0.0.1:{port}/soundfont-for-samplers/FluidR3_GM/"
}
main.py
+62 -2
View File
@@ -2,11 +2,14 @@
from __future__ import annotations
import argparse
import json
import logging
import shutil
import threading
import urllib.parse
import uuid
import webbrowser
from contextlib import asynccontextmanager
from pathlib import Path
from typing import Optional
@@ -15,7 +18,8 @@ import httpx
import uvicorn
from fastapi import FastAPI, File, Form, HTTPException, Request, UploadFile
from fastapi.middleware.cors import CORSMiddleware
from fastapi.responses import FileResponse, Response
from fastapi.responses import FileResponse, RedirectResponse, Response
from fastapi.staticfiles import StaticFiles
from pydantic import BaseModel, ConfigDict
from services.model_manager import ModelManager, ModelNotActiveError, model_manager
@@ -23,6 +27,9 @@ from services.acestep_client import ACESTEP_BASE_URL
from services.foundation1_client import FOUNDATION1_BASE_URL
from services.separator_runner import ALLOWED_MODELS, OUTPUT_DIR, UPLOAD_DIR, separator_runner
_KGSTUDIO_DIST = Path(__file__).parent / "kgstudio" / "dist"
_SOUNDFONTS_DIR = Path(__file__).parent / "soundfonts"
logging.basicConfig(level=logging.INFO, format="%(asctime)s %(levelname)s %(name)s: %(message)s")
logger = logging.getLogger(__name__)
@@ -32,6 +39,10 @@ logger = logging.getLogger(__name__)
@asynccontextmanager
async def lifespan(app: FastAPI):
display_host = getattr(app.state, "display_host", "127.0.0.1")
port = getattr(app.state, "port", 8000)
url = f"http://{display_host}:{port}/kgstudio/"
threading.Timer(1.5, webbrowser.open, args=[url]).start()
async with httpx.AsyncClient(timeout=300.0) as client:
app.state.http_client = client
yield
@@ -52,6 +63,9 @@ app.add_middleware(
allow_headers=["*"],
)
if _SOUNDFONTS_DIR.is_dir():
app.mount("/soundfont-for-samplers", StaticFiles(directory=str(_SOUNDFONTS_DIR)), name="soundfonts")
# ---------------------------------------------------------------------------
# Helpers
# ---------------------------------------------------------------------------
@@ -505,12 +519,58 @@ async def separator_download(filename: str):
)
# ---------------------------------------------------------------------------
# /kgstudio — K.G.Studio static SPA
# ---------------------------------------------------------------------------
@app.get("/", include_in_schema=False)
async def kgstudio_root_redirect():
return RedirectResponse(url="/kgstudio/", status_code=302)
@app.get("/kgstudio/{full_path:path}", include_in_schema=False)
async def kgstudio_spa(full_path: str):
candidate = _KGSTUDIO_DIST / full_path
if candidate.is_file():
return FileResponse(str(candidate))
return FileResponse(str(_KGSTUDIO_DIST / "index.html"))
# ---------------------------------------------------------------------------
# Entry point
# ---------------------------------------------------------------------------
def _write_server_config(port: int) -> None:
"""Copy kgone-server.json to kgstudio/dist/ with {port} replaced by the actual port."""
src = Path(__file__).parent / "kgone-server.json"
dst = _KGSTUDIO_DIST / "kgone-server.json"
if not src.is_file():
logger.warning("kgone-server.json not found — skipping KGStudio config injection")
return
content = src.read_text(encoding="utf-8").replace("{port}", str(port))
dst.write_text(content, encoding="utf-8")
logger.info("Wrote %s", dst)
def main():
uvicorn.run(app, host="0.0.0.0", port=8000, log_level="info")
parser = argparse.ArgumentParser(description="KGOne Gateway")
parser.add_argument("--host", default="127.0.0.1",
help="Host to bind (default: 127.0.0.1; use 0.0.0.0 for remote access)")
parser.add_argument("--port", type=int, default=8000,
help="Port to bind (default: 8000)")
args = parser.parse_args()
display_host = "127.0.0.1" if args.host == "0.0.0.0" else args.host
app.state.host = args.host
app.state.port = args.port
app.state.display_host = display_host
_write_server_config(args.port)
print(f"\nK.G.Studio: http://{display_host}:{args.port}/kgstudio/")
print(f"API docs: http://{display_host}:{args.port}/docs\n")
uvicorn.run(app, host=args.host, port=args.port, log_level="info")
if __name__ == "__main__":
submodules.json
+11
View File
@@ -16,5 +16,16 @@
"commit": "0a644dbb07d94a7e747d5265e3abbaf600459449",
"description": "fix: synchronous endpoint + Cloud Run scaling (2026-03-26)",
"dir": "separator"
},
"kgstudio": {
"url": "https://github.com/KGAudioLab/K.G.Studio.git",
"description": "K.G.Studio browser DAW frontend (always latest main)",
"dir": "kgstudio"
},
"soundfont-for-samplers": {
"url": "https://github.com/KGAudioLab/soundfont-for-samplers.git",
"commit": "9281ba35c0bd8d24c881009f36b5766bc74b15ee",
"description": "FluidR3_GM soundfont MP3 samples for KGStudio MIDI playback",
"dir": "soundfonts"
}
}