spawnpoint-studio 0.1.0__tar.gz → 0.1.1__tar.gz

{spawnpoint_studio-0.1.0/compiler/spawnpoint_studio.egg-info → spawnpoint_studio-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: spawnpoint-studio
-Version: 0.1.0
+Version: 0.1.1
 Summary: Turn a sentence into a juicy, playable Godot 4 game — locally, on a consumer GPU.
 Author: smoky1496
 License: MIT
@@ -24,7 +24,12 @@ Dynamic: license-file
 
 # Spawn Point
 
-**Compile a small JSON "game graph" into a juicy, runnable Godot 4 game — in seconds.**
+**Describe a 2D game in one sentence — get a playable, juicy Godot 4 game in seconds.**
+
+[![CI](https://github.com/leluong141996-dev/Spawn-Point/actions/workflows/ci.yml/badge.svg)](https://github.com/leluong141996-dev/Spawn-Point/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/spawnpoint-studio)](https://pypi.org/project/spawnpoint-studio/)
+[![Model](https://img.shields.io/badge/%F0%9F%A4%97%20model-SpawnPoint--Coder--7B-yellow)](https://huggingface.co/smoky1496/SpawnPoint-Coder-7B-AWQ)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
 
 <p align="center">
   <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/pixel-hopper.gif" width="48%" alt="Pixel Hopper — generated platformer">
@@ -34,7 +39,7 @@ Dynamic: license-file
 <code>examples/pixel_arena.json</code>: generated sprites, collision traced from pixels, juice on by
 default. Recorded with <code>spawnpoint gif</code> (autopilot).</sub></p>
 
-Spawn Point is the foundation of an autonomous game-studio agent. Instead of asking an LLM to type
+Spawn Point is an open-source, autonomous game studio that runs on your own machine. Instead of asking an LLM to type
 hundreds of lines of GDScript (slow, expensive, and easy to break with Godot 3/4 mix-ups), the LLM
 assembles **pre-tested components** like LEGO, places them on an **ASCII map**, and wires gameplay
 with **declarative rules**. A deterministic compiler validates everything and lets Godot itself write
@@ -54,6 +59,24 @@ graph.json ──► validate (Python) ──► build scenes (Godot headless)
 | Hitboxes | drift from visuals | derived from the same shape as the visual |
 | Failure mode | crashes, syntax errors | structured diagnostics *before* Godot runs |
 
+## Install
+
+Requirements: Python ≥ 3.10, [Godot 4.6](https://godotengine.org/download) on your `PATH` (`godot4` or
+`godot`, or set `GODOT_BIN`), and for the LLM features either a 12 GB NVIDIA GPU with Docker (local model)
+or any OpenAI-compatible API.
+
+```bash
+pip install spawnpoint-studio
+spawnpoint llm up                      # serves SpawnPoint-Coder-7B locally (or set SPAWNPOINT_LLM_* for an API)
+spawnpoint create "a ninja platformer where you collect stars"
+```
+
+No GPU? Try the hand-written examples, no LLM needed:
+
+```bash
+spawnpoint examples copy pixel_hopper && spawnpoint build pixel_hopper.json --run
+```
+
 ## Spawn Point Studio (web cockpit)
 
 ```bash
@@ -223,13 +246,10 @@ stop making the mistakes the normalizer and compiler had to fix (roadmap item 7)
 
 ## Quick start (hand-written graphs)
 
-Requirements: Python ≥ 3.10 and [Godot 4.6](https://godotengine.org/download) on your `PATH`
-(`godot4` or `godot`, or set `GODOT_BIN`).
-
 ```bash
-pip install -e ".[dev]"
-spawnpoint build examples/coin_hopper.json --run     # platformer
-spawnpoint build examples/neon_arena.json --run      # top-down shooter
+spawnpoint examples list
+spawnpoint examples copy coin_hopper && spawnpoint build coin_hopper.json --run   # platformer
+spawnpoint examples copy neon_arena && spawnpoint build neon_arena.json --run     # top-down shooter
 ```
 
 Controls: move **WASD / arrows**, jump **Space / Z / W**, dash **Shift / C**, shoot **X / J / left mouse**,
@@ -321,15 +341,20 @@ godot/                     Godot project hosting the component library and its t
   tests/                   headless GDScript tests
 compiler/spawnpoint/       Python compiler: graph schema, analysis, rules codegen, sfx, CLI
 compiler/spawnpoint/studio LLM orchestrator: brief, assembler, level generators, web export, browser check
-compiler/spawnpoint/sprites SpriteSet format, pixel-art generator, importer, contour → collision
+compiler/spawnpoint/sprites SpriteSet format, pixel-art generator and tiles, importer, contour → collision, AI-art providers
+compiler/spawnpoint/playtest bots, jump-aware planner, telemetry, heatmaps, tuner
+compiler/spawnpoint/cockpit web studio: HTTP + SSE server and the single-page UI
 compiler/tests/            pytest (includes end-to-end builds and the GDScript suite)
 examples/                  example graphs
-docs/                      design specs
+scripts/                   helper scripts (local LLM)
+docs/media/                README GIFs
 ```
 
 ## Development
 
 ```bash
+git clone https://github.com/leluong141996-dev/Spawn-Point && cd Spawn-Point
+pip install -e ".[dev]"
 pytest                      # everything: compiler, studio, end-to-end builds, web + browser, GDScript suite
 pytest -m "not llm"         # without the live-LLM tests
 spawnpoint manifest         # regenerate manifest.json after changing a component
@@ -340,6 +365,9 @@ Adding a component: create `godot/addons/spawn_point/components/<name>_component
 contract (typed `@export`s with ranges, `SP_NAME` / `SP_HOSTS` / `SP_REQUIRES` / `SP_CATEGORY`
 constants, `##` docs on everything public), add tests in `godot/tests/`, then run `spawnpoint manifest`.
 
+Contributions are welcome: open an issue to discuss a bigger change first, keep `pytest -m "not llm"`
+green, and add a test with every fix. CI runs the full suite (with Godot) on every push and pull request.
+
 ## Roadmap
 
 1. ✅ Component library with juice

{spawnpoint_studio-0.1.0 → spawnpoint_studio-0.1.1}/README.md

@@ -1,6 +1,11 @@
 # Spawn Point
 
-**Compile a small JSON "game graph" into a juicy, runnable Godot 4 game — in seconds.**
+**Describe a 2D game in one sentence — get a playable, juicy Godot 4 game in seconds.**
+
+[![CI](https://github.com/leluong141996-dev/Spawn-Point/actions/workflows/ci.yml/badge.svg)](https://github.com/leluong141996-dev/Spawn-Point/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/spawnpoint-studio)](https://pypi.org/project/spawnpoint-studio/)
+[![Model](https://img.shields.io/badge/%F0%9F%A4%97%20model-SpawnPoint--Coder--7B-yellow)](https://huggingface.co/smoky1496/SpawnPoint-Coder-7B-AWQ)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
 
 <p align="center">
   <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/pixel-hopper.gif" width="48%" alt="Pixel Hopper — generated platformer">
@@ -10,7 +15,7 @@
 <code>examples/pixel_arena.json</code>: generated sprites, collision traced from pixels, juice on by
 default. Recorded with <code>spawnpoint gif</code> (autopilot).</sub></p>
 
-Spawn Point is the foundation of an autonomous game-studio agent. Instead of asking an LLM to type
+Spawn Point is an open-source, autonomous game studio that runs on your own machine. Instead of asking an LLM to type
 hundreds of lines of GDScript (slow, expensive, and easy to break with Godot 3/4 mix-ups), the LLM
 assembles **pre-tested components** like LEGO, places them on an **ASCII map**, and wires gameplay
 with **declarative rules**. A deterministic compiler validates everything and lets Godot itself write
@@ -30,6 +35,24 @@ graph.json ──► validate (Python) ──► build scenes (Godot headless)
 | Hitboxes | drift from visuals | derived from the same shape as the visual |
 | Failure mode | crashes, syntax errors | structured diagnostics *before* Godot runs |
 
+## Install
+
+Requirements: Python ≥ 3.10, [Godot 4.6](https://godotengine.org/download) on your `PATH` (`godot4` or
+`godot`, or set `GODOT_BIN`), and for the LLM features either a 12 GB NVIDIA GPU with Docker (local model)
+or any OpenAI-compatible API.
+
+```bash
+pip install spawnpoint-studio
+spawnpoint llm up                      # serves SpawnPoint-Coder-7B locally (or set SPAWNPOINT_LLM_* for an API)
+spawnpoint create "a ninja platformer where you collect stars"
+```
+
+No GPU? Try the hand-written examples, no LLM needed:
+
+```bash
+spawnpoint examples copy pixel_hopper && spawnpoint build pixel_hopper.json --run
+```
+
 ## Spawn Point Studio (web cockpit)
 
 ```bash
@@ -199,13 +222,10 @@ stop making the mistakes the normalizer and compiler had to fix (roadmap item 7)
 
 ## Quick start (hand-written graphs)
 
-Requirements: Python ≥ 3.10 and [Godot 4.6](https://godotengine.org/download) on your `PATH`
-(`godot4` or `godot`, or set `GODOT_BIN`).
-
 ```bash
-pip install -e ".[dev]"
-spawnpoint build examples/coin_hopper.json --run     # platformer
-spawnpoint build examples/neon_arena.json --run      # top-down shooter
+spawnpoint examples list
+spawnpoint examples copy coin_hopper && spawnpoint build coin_hopper.json --run   # platformer
+spawnpoint examples copy neon_arena && spawnpoint build neon_arena.json --run     # top-down shooter
 ```
 
 Controls: move **WASD / arrows**, jump **Space / Z / W**, dash **Shift / C**, shoot **X / J / left mouse**,
@@ -297,15 +317,20 @@ godot/                     Godot project hosting the component library and its t
   tests/                   headless GDScript tests
 compiler/spawnpoint/       Python compiler: graph schema, analysis, rules codegen, sfx, CLI
 compiler/spawnpoint/studio LLM orchestrator: brief, assembler, level generators, web export, browser check
-compiler/spawnpoint/sprites SpriteSet format, pixel-art generator, importer, contour → collision
+compiler/spawnpoint/sprites SpriteSet format, pixel-art generator and tiles, importer, contour → collision, AI-art providers
+compiler/spawnpoint/playtest bots, jump-aware planner, telemetry, heatmaps, tuner
+compiler/spawnpoint/cockpit web studio: HTTP + SSE server and the single-page UI
 compiler/tests/            pytest (includes end-to-end builds and the GDScript suite)
 examples/                  example graphs
-docs/                      design specs
+scripts/                   helper scripts (local LLM)
+docs/media/                README GIFs
 ```
 
 ## Development
 
 ```bash
+git clone https://github.com/leluong141996-dev/Spawn-Point && cd Spawn-Point
+pip install -e ".[dev]"
 pytest                      # everything: compiler, studio, end-to-end builds, web + browser, GDScript suite
 pytest -m "not llm"         # without the live-LLM tests
 spawnpoint manifest         # regenerate manifest.json after changing a component
@@ -316,6 +341,9 @@ Adding a component: create `godot/addons/spawn_point/components/<name>_component
 contract (typed `@export`s with ranges, `SP_NAME` / `SP_HOSTS` / `SP_REQUIRES` / `SP_CATEGORY`
 constants, `##` docs on everything public), add tests in `godot/tests/`, then run `spawnpoint manifest`.
 
+Contributions are welcome: open an issue to discuss a bigger change first, keep `pytest -m "not llm"`
+green, and add a test with every fix. CI runs the full suite (with Godot) on every push and pull request.
+
 ## Roadmap
 
 1. ✅ Component library with juice

spawnpoint_studio-0.1.1/compiler/spawnpoint/__init__.py

@@ -0,0 +1,8 @@
+"""Spawn Point: compile JSON game graphs into runnable Godot 4 projects."""
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("spawnpoint-studio")  # single source of truth: pyproject.toml
+except PackageNotFoundError:  # running from a source tree that was never installed
+    __version__ = "0.0.0+source"

{spawnpoint_studio-0.1.0 → spawnpoint_studio-0.1.1}/compiler/spawnpoint/studio/webcheck.py

@@ -10,6 +10,7 @@ import json
 import os
 import re
 import shutil
+import signal
 import socket
 import struct
 import subprocess
@@ -106,12 +107,13 @@ def check(url: str, seconds: float = 12.0, size: tuple[int, int] = (960, 540), k
     if chrome is None:
         raise RuntimeError("Chrome not found (set CHROME_BIN)")
     result = WebCheck()
-    with tempfile.TemporaryDirectory() as profile:
+    # Chrome's helper processes can outlive the main one for a moment and keep writing to the profile.
+    with tempfile.TemporaryDirectory(ignore_cleanup_errors=True) as profile:
         proc = subprocess.Popen(
             [chrome, "--headless=new", "--no-sandbox", f"--user-data-dir={profile}", "--remote-debugging-port=0",
              "--use-angle=swiftshader", "--enable-unsafe-swiftshader", "--autoplay-policy=no-user-gesture-required",
              f"--window-size={size[0]},{size[1]}", "about:blank"],
-            stderr=subprocess.PIPE, stdout=subprocess.DEVNULL, text=True)
+            stderr=subprocess.PIPE, stdout=subprocess.DEVNULL, text=True, start_new_session=True)
         try:
             ws_url = _devtools_url(proc)
             port = re.match(r"ws://[^:]+:(\d+)", ws_url).group(1)
@@ -163,14 +165,30 @@ def check(url: str, seconds: float = 12.0, size: tuple[int, int] = (960, 540), k
                 result.value = ev.get("result", {}).get("value")
             ws.close()
         finally:
-            proc.terminate()
-            try:
-                proc.wait(timeout=10)
-            except subprocess.TimeoutExpired:
-                proc.kill()
+            _stop(proc)
     return result
 
 
+def _stop(proc: subprocess.Popen) -> None:
+    """Stop Chrome and every helper process it started (they share its process group)."""
+    for sig in (signal.SIGTERM, signal.SIGKILL):
+        try:
+            os.killpg(proc.pid, sig)
+        except ProcessLookupError:
+            return
+        try:
+            proc.wait(timeout=10)
+        except subprocess.TimeoutExpired:
+            continue
+        deadline = time.time() + 5  # the main process is gone; give the helpers a moment to follow
+        while time.time() < deadline:
+            try:
+                os.killpg(proc.pid, 0)
+            except ProcessLookupError:
+                return
+            time.sleep(0.05)
+
+
 def _devtools_url(proc: subprocess.Popen) -> str:
     deadline = time.time() + 20
     while time.time() < deadline:

{spawnpoint_studio-0.1.0 → spawnpoint_studio-0.1.1/compiler/spawnpoint_studio.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: spawnpoint-studio
-Version: 0.1.0
+Version: 0.1.1
 Summary: Turn a sentence into a juicy, playable Godot 4 game — locally, on a consumer GPU.
 Author: smoky1496
 License: MIT
@@ -24,7 +24,12 @@ Dynamic: license-file
 
 # Spawn Point
 
-**Compile a small JSON "game graph" into a juicy, runnable Godot 4 game — in seconds.**
+**Describe a 2D game in one sentence — get a playable, juicy Godot 4 game in seconds.**
+
+[![CI](https://github.com/leluong141996-dev/Spawn-Point/actions/workflows/ci.yml/badge.svg)](https://github.com/leluong141996-dev/Spawn-Point/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/spawnpoint-studio)](https://pypi.org/project/spawnpoint-studio/)
+[![Model](https://img.shields.io/badge/%F0%9F%A4%97%20model-SpawnPoint--Coder--7B-yellow)](https://huggingface.co/smoky1496/SpawnPoint-Coder-7B-AWQ)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
 
 <p align="center">
   <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/pixel-hopper.gif" width="48%" alt="Pixel Hopper — generated platformer">
@@ -34,7 +39,7 @@ Dynamic: license-file
 <code>examples/pixel_arena.json</code>: generated sprites, collision traced from pixels, juice on by
 default. Recorded with <code>spawnpoint gif</code> (autopilot).</sub></p>
 
-Spawn Point is the foundation of an autonomous game-studio agent. Instead of asking an LLM to type
+Spawn Point is an open-source, autonomous game studio that runs on your own machine. Instead of asking an LLM to type
 hundreds of lines of GDScript (slow, expensive, and easy to break with Godot 3/4 mix-ups), the LLM
 assembles **pre-tested components** like LEGO, places them on an **ASCII map**, and wires gameplay
 with **declarative rules**. A deterministic compiler validates everything and lets Godot itself write
@@ -54,6 +59,24 @@ graph.json ──► validate (Python) ──► build scenes (Godot headless)
 | Hitboxes | drift from visuals | derived from the same shape as the visual |
 | Failure mode | crashes, syntax errors | structured diagnostics *before* Godot runs |
 
+## Install
+
+Requirements: Python ≥ 3.10, [Godot 4.6](https://godotengine.org/download) on your `PATH` (`godot4` or
+`godot`, or set `GODOT_BIN`), and for the LLM features either a 12 GB NVIDIA GPU with Docker (local model)
+or any OpenAI-compatible API.
+
+```bash
+pip install spawnpoint-studio
+spawnpoint llm up                      # serves SpawnPoint-Coder-7B locally (or set SPAWNPOINT_LLM_* for an API)
+spawnpoint create "a ninja platformer where you collect stars"
+```
+
+No GPU? Try the hand-written examples, no LLM needed:
+
+```bash
+spawnpoint examples copy pixel_hopper && spawnpoint build pixel_hopper.json --run
+```
+
 ## Spawn Point Studio (web cockpit)
 
 ```bash
@@ -223,13 +246,10 @@ stop making the mistakes the normalizer and compiler had to fix (roadmap item 7)
 
 ## Quick start (hand-written graphs)
 
-Requirements: Python ≥ 3.10 and [Godot 4.6](https://godotengine.org/download) on your `PATH`
-(`godot4` or `godot`, or set `GODOT_BIN`).
-
 ```bash
-pip install -e ".[dev]"
-spawnpoint build examples/coin_hopper.json --run     # platformer
-spawnpoint build examples/neon_arena.json --run      # top-down shooter
+spawnpoint examples list
+spawnpoint examples copy coin_hopper && spawnpoint build coin_hopper.json --run   # platformer
+spawnpoint examples copy neon_arena && spawnpoint build neon_arena.json --run     # top-down shooter
 ```
 
 Controls: move **WASD / arrows**, jump **Space / Z / W**, dash **Shift / C**, shoot **X / J / left mouse**,
@@ -321,15 +341,20 @@ godot/                     Godot project hosting the component library and its t
   tests/                   headless GDScript tests
 compiler/spawnpoint/       Python compiler: graph schema, analysis, rules codegen, sfx, CLI
 compiler/spawnpoint/studio LLM orchestrator: brief, assembler, level generators, web export, browser check
-compiler/spawnpoint/sprites SpriteSet format, pixel-art generator, importer, contour → collision
+compiler/spawnpoint/sprites SpriteSet format, pixel-art generator and tiles, importer, contour → collision, AI-art providers
+compiler/spawnpoint/playtest bots, jump-aware planner, telemetry, heatmaps, tuner
+compiler/spawnpoint/cockpit web studio: HTTP + SSE server and the single-page UI
 compiler/tests/            pytest (includes end-to-end builds and the GDScript suite)
 examples/                  example graphs
-docs/                      design specs
+scripts/                   helper scripts (local LLM)
+docs/media/                README GIFs
 ```
 
 ## Development
 
 ```bash
+git clone https://github.com/leluong141996-dev/Spawn-Point && cd Spawn-Point
+pip install -e ".[dev]"
 pytest                      # everything: compiler, studio, end-to-end builds, web + browser, GDScript suite
 pytest -m "not llm"         # without the live-LLM tests
 spawnpoint manifest         # regenerate manifest.json after changing a component
@@ -340,6 +365,9 @@ Adding a component: create `godot/addons/spawn_point/components/<name>_component
 contract (typed `@export`s with ranges, `SP_NAME` / `SP_HOSTS` / `SP_REQUIRES` / `SP_CATEGORY`
 constants, `##` docs on everything public), add tests in `godot/tests/`, then run `spawnpoint manifest`.
 
+Contributions are welcome: open an issue to discuss a bigger change first, keep `pytest -m "not llm"`
+green, and add a test with every fix. CI runs the full suite (with Godot) on every push and pull request.
+
 ## Roadmap
 
 1. ✅ Component library with juice

{spawnpoint_studio-0.1.0 → spawnpoint_studio-0.1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "spawnpoint-studio"
-version = "0.1.0"
+version = "0.1.1"
 description = "Turn a sentence into a juicy, playable Godot 4 game — locally, on a consumer GPU."
 readme = "README.md"
 requires-python = ">=3.10"

spawnpoint_studio-0.1.0/compiler/spawnpoint/__init__.py

@@ -1,3 +0,0 @@
-"""Spawn Point: compile JSON game graphs into runnable Godot 4 projects."""
-
-__version__ = "0.1.0"