chump-server 0.0.41

Python backend for the chump coding assistant

chump-server

The backend hosts ChumpAgent instances over ai-query's built-in agent server routes.

Run

uv sync
uv run chump-server

Install

End-user Chump release archives bundle a platform-specific chump-server binary next to the CLI. The PyPI package remains useful for development, debugging, and direct backend runs:

uv run chump-server

During repository development, uv still uses the local editable ../ai-query source from pyproject.toml.

Build a local standalone backend binary:

python scripts/build_binary.py

The output is written to dist/bin/chump-server-<platform>. Use python scripts/build_binary.py --mode onedir --archive to produce the release archive at dist/bin/chump-server-<platform>.tar.gz.

Release

chump-server versions come from git tags through hatch-vcs.

git tag chump-server-v0.1.0
git push origin chump-server-v0.1.0

Pushing a chump-server-v* tag runs the PyPI job and creates a GitHub Release in .github/workflows/release.yml. The same release also gets platform-specific standalone backend runtime archives named chump-server-<platform>.tar.gz attached for sandbox/server-only deployments. Legacy onefile assets named chump-server-<platform> are also attached so older clients can update across the runtime archive transition.

Environment

• CHUMP_HOST: default 127.0.0.1
• CHUMP_PORT: default 8080
• CHUMP_WORKSPACE_ROOT: defaults to the parent directory of server/
• CHUMP_STATE_DIR: optional override for the workspace state directory; defaults to a per-workspace path under the user's OS state/data directory
• CHUMP_PROVIDER: default chump_cloud; also supports codex, github_copilot, openai, google, anthropic, workers_ai, deepseek, openrouter, groq, xai, opencode, opencode_go, and zenmux
• CHUMP_MODEL: provider-specific default
• CHUMP_CLOUD_BASE_URL: optional OpenAI-compatible base URL for the chump_cloud provider
• CHUMP_MAX_STEPS: default 250
• CHUMP_RETRY_MAX_ATTEMPTS: provider-call retry attempts; default 3, set 1 to disable
• CHUMP_RETRY_INITIAL_DELAY: initial retry delay in seconds; default 0.5
• CHUMP_RETRY_MAX_DELAY: max retry delay in seconds; default 8
• CHUMP_RETRY_BACKOFF: retry delay multiplier; default 2
• CHUMP_RETRY_JITTER: enable retry jitter; default 1
• CHUMP_COMMAND_TIMEOUT: default 120
• CHUMP_MANAGED_SERVER_IDLE_TIMEOUT: optional process idle shutdown timeout in seconds
• CHUMP_REASONING_EFFORT: optional OpenAI-compatible reasoning effort
• CHUMP_REASONING_BUDGET: optional Gemini-compatible thinking budget
• CHUMP_VERBOSE: default 1