pycentauri 0.1.1__tar.gz → 0.3.0__tar.gz

{pycentauri-0.1.1 → pycentauri-0.3.0}/CHANGELOG.md

@@ -6,6 +6,45 @@ Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [0.3.0] - 2026-04-22
+
+### Added
+- **Web UI** at `GET /ui/` (and `GET /` redirects there). Single static
+  dashboard bundled in the wheel — no build step, no framework. Shows
+  live webcam (MJPEG), progress bar, layer counter, temperature cards,
+  position, fans, and Z-offset. Pause / Resume / Stop buttons auto-appear
+  when the server is launched with `--enable-control`.
+- `GET /stream` — MJPEG proxy through the API server to the printer's
+  `:3031/video`. Browsers render it directly in an `<img>` tag.
+- `GET /api/info` — JSON health endpoint, matching what `GET /` used to
+  return before it was repurposed to redirect to `/ui/`.
+
+### Changed
+- `GET /` now redirects to `/ui/` (307). If the web assets aren't found
+  in the wheel (custom build, etc.), `/` falls back to a minimal JSON
+  health response so scripted clients don't break.
+
+## [0.2.0] - 2026-04-22
+
+### Added
+- **HTTP + SSE server.** `centauri server [--host IP] [--bind 127.0.0.1]
+  [--port 8787] [--enable-control]` runs a FastAPI app that wraps the
+  same client library used by the CLI and MCP server:
+  - `GET /` — health, version, connection state
+  - `GET /status` — latest status snapshot (JSON)
+  - `GET /attributes` — printer attributes (JSON)
+  - `GET /snapshot` — single JPEG frame from the webcam
+  - `GET /discover` — UDP LAN scan
+  - `GET /events/status` — Server-Sent Events stream of live status pushes
+  - `POST /print/{start,pause,resume,stop}` — only registered with
+    `--enable-control` (mirrors the MCP security posture — the routes
+    literally don't exist without the flag)
+- New optional extra: `pip install 'pycentauri[server]'` pulls in
+  FastAPI + uvicorn + sse-starlette.
+- The server holds a single long-lived WebSocket for its lifetime with
+  auto-reconnect and exponential backoff, so it never bumps against the
+  printer's 5-slot limit and HTTP requests return cached pushes instantly.
+
 ## [0.1.1] - 2026-04-22
 
 ### Fixed

{pycentauri-0.1.1 → pycentauri-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pycentauri
-Version: 0.1.1
+Version: 0.3.0
 Summary: Python client and MCP server for Elegoo Centauri Carbon 3D printers
 Project-URL: Homepage, https://github.com/bjan/pycentauri
 Project-URL: Repository, https://github.com/bjan/pycentauri
@@ -28,13 +28,22 @@ Requires-Dist: pydantic>=2.7
 Requires-Dist: typer>=0.12
 Requires-Dist: websockets>=12.0
 Provides-Extra: dev
+Requires-Dist: fastapi>=0.110; extra == 'dev'
+Requires-Dist: httpx>=0.27; extra == 'dev'
+Requires-Dist: mcp>=1.2; extra == 'dev'
 Requires-Dist: mypy>=1.10; extra == 'dev'
 Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
 Requires-Dist: pytest-cov>=5.0; extra == 'dev'
 Requires-Dist: pytest>=8.0; extra == 'dev'
 Requires-Dist: ruff>=0.5; extra == 'dev'
+Requires-Dist: sse-starlette>=2.0; extra == 'dev'
+Requires-Dist: uvicorn[standard]>=0.29; extra == 'dev'
 Provides-Extra: mcp
 Requires-Dist: mcp>=1.2; extra == 'mcp'
+Provides-Extra: server
+Requires-Dist: fastapi>=0.110; extra == 'server'
+Requires-Dist: sse-starlette>=2.0; extra == 'server'
+Requires-Dist: uvicorn[standard]>=0.29; extra == 'server'
 Description-Content-Type: text/markdown
 
 # pycentauri
@@ -43,12 +52,16 @@ Python client, CLI, and MCP server for the [Elegoo Centauri
 Carbon](https://www.elegoo.com/) 3D printer.
 
 `pycentauri` speaks the printer's native SDCP v3 protocol over its local
-WebSocket (port 3030) — no cloud account required. It exposes three surfaces:
+WebSocket (port 3030) — no cloud account required. It exposes five surfaces:
 
 1. An **async Python library** for direct integration.
 2. A **`centauri` CLI** for quick status checks, snapshots, and control.
 3. An **MCP server** so AI agents (Claude Code, Claude Desktop, Cursor, any
    MCP-compatible client) can monitor and drive the printer as a tool.
+4. An **HTTP + SSE server** for dashboards, reverse-proxy integration, and
+   anything that wants a plain REST API.
+5. A **built-in web UI** (dark theme, mobile-friendly) served at `/ui/` by
+   the HTTP server — live webcam, progress, temperatures, and control.
 
 > **Status:** alpha. The protocol has been reverse-engineered from the official
 > [`elegoo-link`](https://github.com/ELEGOO-3D/elegoo-link) C++ SDK and the
@@ -59,8 +72,10 @@ WebSocket (port 3030) — no cloud account required. It exposes three surfaces:
 ## Install
 
 ```sh
-pip install pycentauri            # library + CLI
-pip install "pycentauri[mcp]"     # + MCP server dependencies
+pip install pycentauri                    # library + CLI
+pip install "pycentauri[mcp]"             # + MCP server
+pip install "pycentauri[server]"          # + HTTP REST/SSE server
+pip install "pycentauri[mcp,server]"      # everything
 ```
 
 ## Quick start — CLI
@@ -112,6 +127,34 @@ async def main():
 asyncio.run(main())
 ```
 
+## Quick start — HTTP server
+
+```sh
+# Read-only, bound to loopback so only this box can hit it:
+centauri server --host 192.168.1.209 --port 8787
+
+# Read + write, bound to all interfaces (put a reverse proxy in front):
+centauri server --host 192.168.1.209 --bind 0.0.0.0 --port 8787 --enable-control
+```
+
+| Method | Path | Notes |
+|---|---|---|
+| `GET` | `/` | Redirects to `/ui/` |
+| `GET` | `/ui/` | Built-in web dashboard |
+| `GET` | `/api/info` | Health + version (JSON) |
+| `GET` | `/status` | Latest status push (cached; updates every ~5s) |
+| `GET` | `/attributes` | Printer attributes |
+| `GET` | `/snapshot` | `image/jpeg` response |
+| `GET` | `/stream` | MJPEG stream proxied from the printer (embeds in `<img>`) |
+| `GET` | `/discover` | LAN scan |
+| `GET` | `/events/status` | Server-Sent Events stream of pushes |
+| `POST` | `/print/start` | Body: `{"filename": "cube.gcode"}`. Requires `--enable-control`. |
+| `POST` | `/print/{pause,resume,stop}` | Requires `--enable-control`. |
+
+The server holds a single long-lived WebSocket to the printer and reuses
+it for every request — no per-request reconnect, and it won't bump into
+the firmware's 5-slot limit.
+
 ## Quick start — MCP
 
 Register the server with your agent. With Claude Code:

{pycentauri-0.1.1 → pycentauri-0.3.0}/README.md

@@ -4,12 +4,16 @@ Python client, CLI, and MCP server for the [Elegoo Centauri
 Carbon](https://www.elegoo.com/) 3D printer.
 
 `pycentauri` speaks the printer's native SDCP v3 protocol over its local
-WebSocket (port 3030) — no cloud account required. It exposes three surfaces:
+WebSocket (port 3030) — no cloud account required. It exposes five surfaces:
 
 1. An **async Python library** for direct integration.
 2. A **`centauri` CLI** for quick status checks, snapshots, and control.
 3. An **MCP server** so AI agents (Claude Code, Claude Desktop, Cursor, any
    MCP-compatible client) can monitor and drive the printer as a tool.
+4. An **HTTP + SSE server** for dashboards, reverse-proxy integration, and
+   anything that wants a plain REST API.
+5. A **built-in web UI** (dark theme, mobile-friendly) served at `/ui/` by
+   the HTTP server — live webcam, progress, temperatures, and control.
 
 > **Status:** alpha. The protocol has been reverse-engineered from the official
 > [`elegoo-link`](https://github.com/ELEGOO-3D/elegoo-link) C++ SDK and the
@@ -20,8 +24,10 @@ WebSocket (port 3030) — no cloud account required. It exposes three surfaces:
 ## Install
 
 ```sh
-pip install pycentauri            # library + CLI
-pip install "pycentauri[mcp]"     # + MCP server dependencies
+pip install pycentauri                    # library + CLI
+pip install "pycentauri[mcp]"             # + MCP server
+pip install "pycentauri[server]"          # + HTTP REST/SSE server
+pip install "pycentauri[mcp,server]"      # everything
 ```
 
 ## Quick start — CLI
@@ -73,6 +79,34 @@ async def main():
 asyncio.run(main())
 ```
 
+## Quick start — HTTP server
+
+```sh
+# Read-only, bound to loopback so only this box can hit it:
+centauri server --host 192.168.1.209 --port 8787
+
+# Read + write, bound to all interfaces (put a reverse proxy in front):
+centauri server --host 192.168.1.209 --bind 0.0.0.0 --port 8787 --enable-control
+```
+
+| Method | Path | Notes |
+|---|---|---|
+| `GET` | `/` | Redirects to `/ui/` |
+| `GET` | `/ui/` | Built-in web dashboard |
+| `GET` | `/api/info` | Health + version (JSON) |
+| `GET` | `/status` | Latest status push (cached; updates every ~5s) |
+| `GET` | `/attributes` | Printer attributes |
+| `GET` | `/snapshot` | `image/jpeg` response |
+| `GET` | `/stream` | MJPEG stream proxied from the printer (embeds in `<img>`) |
+| `GET` | `/discover` | LAN scan |
+| `GET` | `/events/status` | Server-Sent Events stream of pushes |
+| `POST` | `/print/start` | Body: `{"filename": "cube.gcode"}`. Requires `--enable-control`. |
+| `POST` | `/print/{pause,resume,stop}` | Requires `--enable-control`. |
+
+The server holds a single long-lived WebSocket to the printer and reuses
+it for every request — no per-request reconnect, and it won't bump into
+the firmware's 5-slot limit.
+
 ## Quick start — MCP
 
 Register the server with your agent. With Claude Code:

{pycentauri-0.1.1 → pycentauri-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pycentauri"
-version = "0.1.1"
+version = "0.3.0"
 description = "Python client and MCP server for Elegoo Centauri Carbon 3D printers"
 readme = "README.md"
 license = "Apache-2.0"
@@ -35,12 +35,15 @@ dependencies = [
 
 [project.optional-dependencies]
 mcp = ["mcp>=1.2"]
+server = ["fastapi>=0.110", "uvicorn[standard]>=0.29", "sse-starlette>=2.0"]
 dev = [
     "pytest>=8.0",
     "pytest-asyncio>=0.23",
     "ruff>=0.5",
     "mypy>=1.10",
     "pytest-cov>=5.0",
+    "httpx>=0.27",
+    "pycentauri[mcp,server]",
 ]
 
 [project.scripts]
@@ -55,6 +58,9 @@ Changelog = "https://github.com/bjan/pycentauri/blob/main/CHANGELOG.md"
 [tool.hatch.build.targets.wheel]
 packages = ["src/pycentauri"]
 
+[tool.hatch.build.targets.sdist]
+include = ["src/pycentauri", "tests", "README.md", "LICENSE", "CHANGELOG.md"]
+
 [tool.ruff]
 line-length = 100
 target-version = "py310"
@@ -63,6 +69,10 @@ target-version = "py310"
 select = ["E", "F", "W", "I", "UP", "B", "SIM", "RUF"]
 ignore = ["E501"]
 
+[tool.ruff.lint.per-file-ignores]
+# FastAPI's idiomatic DI uses `Depends()` in default values; that's B008.
+"src/pycentauri/server.py" = ["B008"]
+
 [tool.mypy]
 python_version = "3.10"
 strict = true

{pycentauri-0.1.1 → pycentauri-0.3.0}/src/pycentauri/__init__.py

@@ -15,4 +15,4 @@ __all__ = [
     "discover",
 ]
 
-__version__ = "0.1.1"
+__version__ = "0.3.0"

{pycentauri-0.1.1 → pycentauri-0.3.0}/src/pycentauri/cli.py

@@ -336,6 +336,38 @@ def cmd_print_stop(host: HostOpt = None, enable_control: ControlOpt = False) ->
     _run(run())
 
 
+@app.command("server")
+def cmd_server(
+    host: HostOpt = None,
+    bind: str = typer.Option(
+        "127.0.0.1", "--bind", help="Interface to bind. Use 0.0.0.0 to expose on LAN."
+    ),
+    port: int = typer.Option(8787, "--port", "-p"),
+    enable_control: ControlOpt = False,
+    log_level: str = typer.Option("info", "--log-level"),
+) -> None:
+    """Run the HTTP + SSE server (requires `pip install 'pycentauri[server]'`)."""
+    try:
+        from pycentauri.server import run as run_server
+    except ImportError as err:
+        _echo_err("Server support not installed. Install with: pip install 'pycentauri[server]'")
+        _echo_err(f"(missing dependency: {err})")
+        raise typer.Exit(code=1) from err
+
+    async def resolve() -> tuple[str, str | None]:
+        return await _resolve_target(host)
+
+    h, mid = asyncio.run(resolve())
+    run_server(
+        h,
+        bind=bind,
+        port=port,
+        enable_control=enable_control,
+        mainboard_id=mid,
+        log_level=log_level,
+    )
+
+
 @app.command("mcp")
 def cmd_mcp(
     enable_control: ControlOpt = False,