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 uses the released ai-query version pinned in pyproject.toml and uv.lock.

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

Prompt-cache benchmark

Chump persists provider-reported token usage for every model step. Report the observed cache hit rate across local sessions, grouped by provider and model:

uv run --project server python server/scripts/benchmark_prompt_cache.py

The report includes two different rates:

  • Request hit: model calls where cached_tokens > 0.
  • Token hit: cached input tokens divided by all input tokens.

Use --provider google (repeatable), --min-calls 10, --json, or --state-root <path> to filter or automate the report. This benchmark reads local telemetry without making model requests or spending provider credits.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.2.1)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for abdulmuminyaqeen from gravatar.com abdulmuminyaqeen

Requires

Python >=3.12

Tags

agent ai backend chump cli

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

chump_server-0.2.0.tar.gz (205.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

chump_server-0.2.0-py3-none-any.whl (98.2 kB view details)

Uploaded Python 3

File details

Details for the file chump_server-0.2.0.tar.gz.

File metadata

  • Download URL: chump_server-0.2.0.tar.gz
  • Upload date:
  • Size: 205.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for chump_server-0.2.0.tar.gz
Algorithm Hash digest
SHA256 e2081da596d941ba00788c5657cc47198589e1b2e9f4232b97d240bf08857b0f
MD5 feab4376c826b8b89fef20329307fb7c
BLAKE2b-256 d028a319fb2617aedad3f70bc5df4c3d3f8e8c66779b6e0f446a5bc162502d7f

See more details on using hashes here.

Provenance

The following attestation bundles were made for chump_server-0.2.0.tar.gz:

Publisher: release.yml on Abdulmumin1/chump

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file chump_server-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: chump_server-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 98.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for chump_server-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9d71cad437f9ffac88f7d22fd96284ba07287e0d5b6f6021f92e3f995320f3cc
MD5 9352271f788f104ddabae34e65439060
BLAKE2b-256 24c0bfc8a8d17b4fa9b280dbf1c3c33d718659dd431f00af2d99cbea7933e9d0

See more details on using hashes here.

Provenance

The following attestation bundles were made for chump_server-0.2.0-py3-none-any.whl:

Publisher: release.yml on Abdulmumin1/chump

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.2.1

2 files

This release

0.2.0 This release

2 files

0.1.24

2 files

0.1.23

2 files

0.1.22

2 files

0.1.21

2 files

0.1.20

2 files

0.1.19

2 files

0.1.18

2 files

0.1.17

2 files

0.1.16

2 files

0.1.15

2 files

0.1.14

2 files

0.1.13

2 files

0.1.12

2 files

0.1.11

2 files

0.1.10

2 files

0.1.9

2 files

0.1.8

2 files

0.1.7

2 files

0.1.6

2 files

0.1.5

2 files

0.1.4

2 files

0.1.3

2 files

0.1.2

2 files

0.1.1

2 files

0.1.0

2 files

0.0.44

2 files

0.0.41

2 files

0.0.40

2 files

0.0.38

2 files

0.0.37

2 files

0.0.36

2 files

0.0.35

2 files

0.0.34

2 files

0.0.33

2 files

0.0.32

2 files

0.0.31

2 files

0.0.30

2 files

0.0.29

2 files

0.0.28

2 files

0.0.26

2 files

0.0.25

2 files

0.0.24

2 files

0.0.23

2 files

0.0.22

2 files

0.0.21

2 files

0.0.20

2 files

0.0.19

2 files

0.0.18

2 files

0.0.17

2 files

0.0.16

2 files

0.0.15

2 files

0.0.14

2 files

0.0.13

2 files

0.0.12

2 files

0.0.11

2 files

0.0.10

2 files

0.0.9

2 files

0.0.8

2 files

0.0.7

2 files

0.0.6

2 files

0.0.5

2 files

0.0.4

2 files

0.0.3

2 files

0.0.2

2 files

0.0.1

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page