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.19.tar.gz (193.0 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.19-py3-none-any.whl (90.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: chump_server-0.1.19.tar.gz
  • Upload date:
  • Size: 193.0 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.19.tar.gz
Algorithm Hash digest
SHA256 0bcf5cdf6a24bf82ed8db466aa8221c2394142368f9f4f9a95784be3878caefc
MD5 3e91637dc72baf8f71df615e4c6d50d6
BLAKE2b-256 e30efd31e2cbba90f9924f90c14bf946f8ce69276533e219c1acc315a547736e

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: chump_server-0.1.19-py3-none-any.whl
  • Upload date:
  • Size: 90.6 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.19-py3-none-any.whl
Algorithm Hash digest
SHA256 23732a27034aece18407f4384f3ea7bc58c22103c5f09f092c8cbd8ee8aca158
MD5 09776da7684763b0f7582091955c868a
BLAKE2b-256 f9b4f2d95eb9083bc793709f09d43f53a7a62da4180f1fe9072afdfd7db76912

See more details on using hashes here.

Provenance

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

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

This release

0.1.19 This release

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