Skip to main content

sorcgcs-server

Local development server for SorcGCS (Sorceress) — game preview, file management, AI code agent support, and GPU-powered green screen removal.

Quick Start

# Using uv (fastest)
uvx sorcgcs-server

# Using pipx
pipx run sorcgcs-server

# Or install and run
pip install sorcgcs-server
sorcgcs-server

One command sets up everything:

  • The local file server (game preview, file API, agent support)
  • The CorridorKey GPU server for AutoSprite green screen removal

On first run, CorridorKey setup runs automatically — clones the repo, downloads the model (~300MB), and installs GPU dependencies (PyTorch).

Options

sorcgcs-server --port 8080       # Custom port (default: 8080)
sorcgcs-server --dir ./games     # Serve a specific directory
sorcgcs-server --no-corridorkey  # Skip CorridorKey GPU server
sorcgcs-server --version         # Show version

What It Does

Local File Server (port 8080)

Lightweight HTTP server (Python stdlib, no dependencies) that provides:

  • Game Preview — Serve HTML5 games with live reload support
  • File API — Read, write, list, search, and manage project files
  • FFmpeg Integration — Audio/video format conversion (if ffmpeg is installed)
  • AI Agent Support — Endpoints for the SorcGCS AI code agent
  • Checkpoint System — Create and restore file snapshots

CorridorKey GPU Server (port 8100)

Neural green screen removal powered by CorridorKey:

  • Auto-setup — Clones repo, downloads model, installs PyTorch on first run
  • GPU inference — NVIDIA CUDA, Apple MPS, or CPU fallback
  • Runs alongside the main server as a background process

Requires: GPU (NVIDIA or Apple Silicon recommended), ~2GB disk, ~4GB VRAM.

API Endpoints

Main Server

Method Path Description
GET /api/status Server status and config
GET /api/games List available games
GET /preview/* Serve game preview files
GET /games/* Serve game files
POST /api/read-file Read a file
POST /api/write-file Write a file
POST /api/list-dir List directory contents
POST /api/search-files Search files by glob pattern
POST /api/run-command Execute a shell command
POST /api/create-dir Create a directory
POST /api/delete-file Delete a file
POST /api/rename-file Rename/move a file
POST /api/ffmpeg-process Process media with FFmpeg

CorridorKey Server

Method Path Description
GET /health GPU server health + VRAM info
POST /process Process image for green screen removal

Requirements

  • Python 3.8+
  • No additional dependencies for the file server (uses Python standard library only)
  • GPU with CUDA or MPS for CorridorKey (optional — use --no-corridorkey to skip)
  • FFmpeg (optional, for media processing)

License

MIT

Metadata

Release files for sorcgcs-server 0.7.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for sorcgcs-server 0.7.0
File Size Uploaded Provenance Actions
sorcgcs_server-0.7.0.tar.gz 19.2 kB Without provenance Details for sorcgcs_server-0.7.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for sorcgcs-server 0.7.0
File Interpreter ABI Platform Actions
sorcgcs_server-0.7.0-py3-none-any.whl Python 3 none any Details for sorcgcs_server-0.7.0-py3-none-any.whl

Total release size: 40.0 kB

Release files / sorcgcs_server-0.7.0.tar.gz

Download URL sorcgcs_server-0.7.0.tar.gz
Size 19.2 kB
Tags Source
SHA-256 checksum
How to use checksums
2716ca57165fc33289dd916b2b531a771d1714d70af160202d63cce5fee3c314
BLAKE2b-256 checksum
How to use checksums
0209be2af68b1dd3ad6c8ab539c3da2ffe97c1254606619fa2071a80d2abca77
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.11

Release files / sorcgcs_server-0.7.0-py3-none-any.whl

Download URL sorcgcs_server-0.7.0-py3-none-any.whl
Size 20.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
62e6251be1595d6cb5aaae9d118d37025b6bb4d384411da720ddb26508f00558
BLAKE2b-256 checksum
How to use checksums
90cced5c412706e1a815d1e00ea7b72fa9e7430757e22ca330a6efee74e9d1a4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.11

Security for sorcgcs-server 0.7.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page