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 23, 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:
Newer release available (0.2.0)

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 23, 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.1.0.tar.gz (77.0 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.1.0-py3-none-any.whl (21.2 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for qwenloop-0.1.0.tar.gz
Algorithm Hash digest
SHA256 7e88d9ba059f3697a16f47270618f820a3996310236399c8db70697fae19e2e9
MD5 ec21487fc2840b5b1c7f2bb7af6a880e
BLAKE2b-256 d3f59f4e870cbeb1fbbca28ffa6b077355ccbc5d14052fba5f75ce47a9904e69

See more details on using hashes here.

Provenance

The following attestation bundles were made for qwenloop-0.1.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.1.0-py3-none-any.whl.

File metadata

  • Download URL: qwenloop-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 21.2 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.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b4cfb13dc36ea6d30769d1c8b57260163d40511d73034e354fa34a399d5109c0
MD5 8b687de1919407cb6f4457f4a928ec27
BLAKE2b-256 61d14bf0a26a6d10ea6515b5ef32724c83d351bf12bbd6f06d164636aa4ce142

See more details on using hashes here.

Provenance

The following attestation bundles were made for qwenloop-0.1.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

0.2.0

2 files

This release

0.1.0 This release

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