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

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.17.tar.gz (182.6 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.17-py3-none-any.whl (84.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: chump_server-0.1.17.tar.gz
  • Upload date:
  • Size: 182.6 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.17.tar.gz
Algorithm Hash digest
SHA256 749c245193945090500bbfa077473d64cce3b3f820f3886c08e16417db438022
MD5 342e846387be6cbe5d44435bcc957608
BLAKE2b-256 322308c79ff94cae68d65a9dd4f4c203f86f2192a14ae6812bcbe3448e9071c5

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: chump_server-0.1.17-py3-none-any.whl
  • Upload date:
  • Size: 84.9 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.17-py3-none-any.whl
Algorithm Hash digest
SHA256 84fd74e054867c8afe5f5ce3b73c5bba0b7c9dcaef3b51d5d0a9ba74e9aa248b
MD5 92df810899f291ff8a58900e6a6321a5
BLAKE2b-256 0962210622fe29da490e7eff00b9d9842f4d38305e351cb33b073795a344cd70

See more details on using hashes here.

Provenance

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

0.1.19

2 files

0.1.18

2 files

This release

0.1.17 This release

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