Lightweight HTTP server that executes Python scripts and returns output.
| Flag | Short | Description | Takes Value |
|---|---|---|---|
--repo |
-r |
Git repository URL to clone and serve Python scripts from | Yes |
--branch |
-b |
Git branch to checkout after cloning the repository | Yes |
--poll |
-p |
Polling interval in seconds to check for repository updates | Yes |
--help |
-h |
Show help message and usage information | No |
-e |
— |
Set environment variables passed to executed Python scripts | Yes |
# Clone a website repo and serve its Python pages on port 8080 scorpiox-server --repo https://git.example.com/org/my-website.git
# Serve from the "staging" branch instead of the default scorpiox-server --repo https://git.example.com/org/my-website.git --branch staging
# Poll the repository every 60 seconds for new commits scorpiox-server -r https://git.example.com/org/site.git -p 60
# Set API keys and config as env vars available to all served scripts scorpiox-server -r https://git.example.com/org/api.git -e API_KEY=sk-abc123 -e DB_HOST=localhost
# Full production setup: specific branch, polling, and env config scorpiox-server --repo https://token@git.company.com/team/prod-site.git --branch main --poll 120 -e ENV=production -e LOG_LEVEL=info # Server starts, clones the repo, and begins serving .py files as HTTP endpoints # Incoming requests are routed to matching Python scripts # GET /dashboard → executes dashboard.py and returns its stdout as the HTTP response # Scripts receive request data via CGI-style environment variables
scorpiox-server --help
scorpiox/scorpiox-server.clibsxutil, yyjson