qwenloop

CI Provenance Python 3.12+ License: MIT Model: Apache--2.0

qwenloop is an autonomous, local Qwen 2.5 Coder 14B runner. It uses a portable llama.cpp/Q5_K_M profile by default and can use BF16 through vLLM on Linux NVIDIA systems with at least 40 GiB of usable VRAM.

Model installation is always explicit. The package, tests, doctor, and Vibey integration never download model weights.

Install

Until the first PyPI release, install the runner from the immutable Git tag or an explicit commit:

uv tool install \
  'qwenloop @ git+https://github.com/adammatthewsteinberger/qwenloop.git@feature/qwenloop-local-engine'

The Python package never bundles model weights.

Quick start

qwenloop model install --profile portable
qwenloop model verify
qwenloop doctor
qwenloop run plan.md --run-id <uuid> --cwd <worktree>

The stable run contract is .qwenloop/runs/<run-id>/, exit code 75 for a graceful wind-down, the QWENLOOP_TASK_FULLY_COMPLETE marker, and a qwenloop-verdict result fence.

Inference profiles

Profile Backend Intended hardware Model installation
portable llama.cpp Q5_K_M Apple Silicon, Linux CPU, supported offload GPUs Explicit qwenloop model install --profile portable
nvidia-bf16 vLLM BF16 Linux NVIDIA with at least 40 GiB free VRAM Operator-managed pinned Hugging Face/vLLM cache

Servers bind to loopback and require a per-launch bearer token. Qwenloop never silently changes backend during a run.

Development

uv sync --extra dev
uv run ruff check .
uv run ruff format --check .
uv run mypy --strict src/qwenloop
uv run lint-imports
uv run pytest -q
uv run bandit -q -r src/qwenloop

First-party code is held to 100% line and branch coverage. Model and hardware smokes are deliberately separate from the hermetic CI suite.

Release workflow

Qwenloop uses develop as its integration branch and main as its release branch. vibey-gh provides provenance fingerprints, merge-train automation, derived versions, promotion, and post-release branch realignment.

License

Qwenloop is MIT licensed. Qwen2.5-Coder model artifacts are separately licensed under Apache License 2.0 and are downloaded only after an explicit operator command.

Project links

Data verified by PyPI on Aug 28, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

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

Credits

PyPI data
Data sourced directly from PyPI's database.

Author: Adam Matthew Steinberger

GitHub Statistics

Data verified by PyPI on Aug 28, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.12

Provides Extra

dev

Tags

ai-agent coding-agent llama-cpp qwen vllm

Classifiers

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

qwenloop-0.2.0.tar.gz (111.7 kB view details)

Uploaded Source

Built Distribution

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

qwenloop-0.2.0-py3-none-any.whl (22.3 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for qwenloop-0.2.0.tar.gz
Algorithm Hash digest
SHA256 da67b6ee1713e48fc67190d2d3bc92ae1075aa2ae44c1135a286a0c6125143ae
MD5 a762ddcbc6a51d429ae3556fecb6b9c9
BLAKE2b-256 f87a391a856161fd2971c5acc378e7860f83355542786f08fa9c14de80955a2a

See more details on using hashes here.

Provenance

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

Publisher: release.yml on adammatthewsteinberger/qwenloop

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

File details

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

File metadata

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

File hashes

Hashes for qwenloop-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6acc6d967f82e766b94bb8ada464c07c8776d93dacebd6c199c381927613a1bb
MD5 e27e76724db8283ab256dbb3a1139ff4
BLAKE2b-256 936b7f9c09f659b47fbb4a3bf01ee620eec0e1a380dfcc18bfea5bbf9a82c052

See more details on using hashes here.

Provenance

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

Publisher: release.yml on adammatthewsteinberger/qwenloop

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

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page