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.1.24.tar.gz (200.7 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.1.24-py3-none-any.whl (94.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: chump_server-0.1.24.tar.gz
  • Upload date:
  • Size: 200.7 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.1.24.tar.gz
Algorithm Hash digest
SHA256 5dcc193ec17051874b3c778fb7eda2a23bd8332aaeaa9e7a8f9244820f7ca814
MD5 c7a377a41aa56516e58250de6158eb49
BLAKE2b-256 406c27e2d6c93be0c6b0f90075e27324bbda3043e7e97c438f7e0e3ff4cc4464

See more details on using hashes here.

Provenance

The following attestation bundles were made for chump_server-0.1.24.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.1.24-py3-none-any.whl.

File metadata

  • Download URL: chump_server-0.1.24-py3-none-any.whl
  • Upload date:
  • Size: 94.7 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.1.24-py3-none-any.whl
Algorithm Hash digest
SHA256 178d07ebde7909494ff1c4fce2e12bce84dde21f5ba44759b80e103d582250dc
MD5 65aa73d9d3cfdca48d28c91d9da5de34
BLAKE2b-256 ddadc9f741726fd70c6176ab820fe7c0027ce2768d82fa71cc01666fe3c3a31c

See more details on using hashes here.

Provenance

The following attestation bundles were made for chump_server-0.1.24-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

0.2.0

2 files

This release

0.1.24 This release

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