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.20.tar.gz (193.3 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.20-py3-none-any.whl (90.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: chump_server-0.1.20.tar.gz
  • Upload date:
  • Size: 193.3 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.20.tar.gz
Algorithm Hash digest
SHA256 757c4059256018d67a0e2a6755c70546b14bbaf3b158ce618a777ba3f529b31c
MD5 d6890b7215b4dbefde2f8d837b89f4fe
BLAKE2b-256 ac4c6a893b61e939fe6fb7676469d87d56ea5d16937ec04776deedee61d36b1a

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: chump_server-0.1.20-py3-none-any.whl
  • Upload date:
  • Size: 90.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.20-py3-none-any.whl
Algorithm Hash digest
SHA256 cf59238fc3a357704fa84b3fb7b6844b63929a37d555ee4ba9f8292f2f9ce98b
MD5 60346be8e24808bea33a5a1a7fa92527
BLAKE2b-256 f143c81dfdb2d3b305df6b96e15bf1c939f3bb8f7dadd1098f230149fcd0cb86

See more details on using hashes here.

Provenance

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

This release

0.1.20 This release

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