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-corridorkeyto 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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.