tqdaemon 0.8.0__tar.gz

tqdaemon-0.8.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,28 @@
+name: Bug report
+description: Something in tq, the daemon or the web UI does not work as documented
+labels: [bug]
+body:
+  - type: textarea
+    id: what
+    attributes:
+      label: What happened
+      description: What you did, what you expected, what you got.
+    validations:
+      required: true
+  - type: textarea
+    id: repro
+    attributes:
+      label: Steps to reproduce
+      description: Minimal task YAML and commands if possible.
+  - type: input
+    id: version
+    attributes:
+      label: Version and OS
+      description: Output of `tq doctor` (version, OS, Python).
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs
+      render: shell

tqdaemon-0.8.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: true

tqdaemon-0.8.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,15 @@
+name: Feature request
+description: Suggest an improvement
+labels: [enhancement]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What are you trying to do that is hard today?
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution

tqdaemon-0.8.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,7 @@
+## What and why
+
+## Checklist
+
+- [ ] Focused tests pass (`uv run pytest tests/<module>.py`)
+- [ ] Docs / CHANGELOG updated if behaviour changed
+- [ ] No secrets or machine-specific paths added

tqdaemon-0.8.0/.github/dependabot.yml

@@ -0,0 +1,14 @@
+version: 2
+updates:
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+  - package-ecosystem: pip
+    directory: /
+    schedule:
+      interval: weekly
+  - package-ecosystem: npm
+    directory: /
+    schedule:
+      interval: weekly

tqdaemon-0.8.0/.github/workflows/ci.yml

@@ -0,0 +1,36 @@
+# CI POSTPONED 2026-08-28 — GitHub Actions billing / spending limit exhausted.
+# Auto triggers removed so this does not burn Actions minutes.
+# Manual `workflow_dispatch` kept for optional resume after billing is restored.
+# F-209: single source of truth is scripts/ci.ps1 (local + Actions).
+# See plan/CI_POSTPONED.md.
+
+name: ci
+
+on:
+  workflow_dispatch:
+    inputs:
+      suite:
+        description: "CI suite"
+        required: true
+        default: fast
+        type: choice
+        options: [fast, full, nightly]
+
+jobs:
+  gate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          python-version: "3.12"
+      - uses: actions/setup-node@v4
+        if: inputs.suite != 'fast'
+        with:
+          node-version: "22"
+      - name: Sync (locked)
+        run: uv sync --locked --group dev
+      - name: Run scripts/ci.ps1
+        shell: pwsh
+        # F-209 / deep-audit: one source of truth — including nightly (was a divergent subset).
+        run: pwsh scripts/ci.ps1 -Mode "${{ inputs.suite }}"

tqdaemon-0.8.0/.github/workflows/pages.yml

@@ -0,0 +1,33 @@
+# Deploy top-level site/ to GitHub Pages (legacy branch Sources only allow / or /docs).
+name: pages
+on:
+  push:
+    branches: [main]
+    paths:
+      - "site/**"
+      - ".github/workflows/pages.yml"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/configure-pages@v5
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: site
+      - id: deployment
+        uses: actions/deploy-pages@v4

tqdaemon-0.8.0/.gitignore

@@ -0,0 +1,18 @@
+# Generated by house publish export — do not commit local verify debris.
+__pycache__/
+*.py[cod]
+*$py.class
+.venv/
+venv/
+.pytest_cache/
+.ruff_cache/
+*.egg-info/
+dist/
+build/
+.publish/
+.DS_Store
+*.db
+*.pkl
+.env
+.env.*
+!.env.example

tqdaemon-0.8.0/AGENTS.md

@@ -0,0 +1,27 @@
+# AGENTS.md — tqdaemon (public)
+
+Bootstrap for agents on the **public** tqdaemon tree.
+
+1. [README.md](README.md) — pitch, install, first win  
+2. [llms.txt](llms.txt) — compact agent index  
+3. [docs/mcp.md](docs/mcp.md) — MCP setup + tools  
+4. [docs/task_standards.md](docs/task_standards.md) — YAML fields  
+5. [docs/agents/task-script-cookbook.md](docs/agents/task-script-cookbook.md) — long jobs with `tq_client`  
+6. [docs/operators/cli.md](docs/operators/cli.md) — full `tq` reference  
+7. [CONTRIBUTING.md](CONTRIBUTING.md) — tests and PRs  
+
+## Hard constraints
+
+- Long jobs → operator-queue YAML (not in-session shells).
+- **Create:** MCP `submit_task` (preferred) or YAML under `experiments/operator_queue/` + `tq sync`. `enqueue_task` only retries terminal tasks.
+- Do not invent CLI commands or YAML keys.
+- Prefer `tq wait` / MCP `wait_for_task` over sleep polling.
+- Set `TQ_OPERATOR` so `started_by` / `my_tasks` work.
+- Default home `~/.tqdaemon`, UI **8765**.
+
+## Tests
+
+```text
+uv sync --group dev
+uv run pytest -q -m "not stress"
+```

tqdaemon-0.8.0/CHANGELOG.md

@@ -0,0 +1,56 @@
+# Changelog
+
+All notable changes to this project are documented here.
+Format based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/);
+this project uses [Semantic Versioning](https://semver.org/).
+
+## [Unreleased]
+
+## [0.8.0] - 2026-11-11
+
+### Changed
+
+- **Renamed the project from `taskqueue` to `tqdaemon`** (PyPI distribution `tqdaemon`; `taskqueue`, `tq` and `task-queue` were taken). The `tq` command is unchanged; the Python package is now `tqdaemon`.
+- New names: `TQDAEMON_HOME` (env), `~/.tqdaemon` (state home), `.tqdaemon/project.yaml` (per-project config), MCP server name `tqdaemon`.
+- Migration: the old env var `TASKQUEUE_HOME`, an existing `~/.taskqueue` home, `.taskqueue/project.yaml` and runs started under the old wrapper module are still recognised. To migrate by hand: stop the daemon, rename `~/.taskqueue` to `~/.tqdaemon`, reinstall (`pip install -U tqdaemon`), `tq start`.
+
+### Added
+
+- Automated demo GIF (`scripts/record_demo.py`), issue/PR templates and Dependabot config; PyPI publishing wired into the house publish flow.
+
+## [0.7.6] - 2026-11-08
+
+### Added
+
+- Slim stranger-facing README (EN/PL/ZH/AR) with hero image, agent CTA, and transparency note (no product phone-home).
+- Marketing GitHub Pages tree under `site/` (landing, sitemap, robots); CLI encyclopedia moved to `docs/operators/cli.md`.
+- Root `llms.txt` and expanded package keywords for discoverability.
+
+### Fixed
+
+- Deep-audit reliability work for remote `stopped` claim paths, MCP mutate helpers, scheduler admit hot path, and web UI SSE/log races (F-244–F-258).
+
+## [0.7.5] - 2026-11-01
+
+### Added
+
+- Queue hygiene report: `tq hygiene` / `tq report --hygiene`, MCP `report` with `kind=hygiene`, and `GET /api/hygiene` — churn rates, multi-use vs flaky classification, and honest archive proposals (`agent_prompt`; never auto-archives).
+- `tq archive --max-completed-runs N` so archive proposals can skip multi-use tasks (hygiene uses `1`).
+- Tasks keep `completed_run_count` / `total_run_count` (schema 33); `tq list` reads them instead of scanning all runs.
+- History tab pages with a fixed offset (Prev/Next) and mounts log/history expand rows only when opened.
+- Help topic `queue-hygiene` and operator/docs notes distinguishing hygiene from retention prune and agent usage summaries.
+- House `publish.manifest.yaml` and dual-tree export readiness for the public GitHub mirror.
+
+### Changed
+
+- Unscoped queue `sort=deps` / `sort=order` require a project filter when more than 2000 tasks match.
+- `/api/deps` applies project, suite, and `project/task_id` focus in SQL before building the graph; unscoped graphs cap the SELECT at 500 nodes.
+- `GET /api/tasks/<project>/<task_id>/runs` is paginated (`limit` default 50, max 200; `offset`).
+- Unscoped `GET /api/task-stats` returns at most 500 tasks (prefer `project=`).
+- History anomaly badges are computed in a batched pass per page instead of one query per completed run.
+
+## [0.7.4] - 2026-10-26
+
+### Added
+
+- Initial public changelog baseline matching `pyproject.toml` version 0.7.4.

tqdaemon-0.8.0/CLAUDE.md

@@ -0,0 +1,10 @@
+# CLAUDE.md — tqdaemon (public)
+
+Public checkout guidance. Prefer [AGENTS.md](AGENTS.md) and [docs/](docs/).
+
+- Package: `tqdaemon/` (`cli.py`, `daemon.py`, `db.py`, `worker.py`, …)
+- Web UI: `tqdaemon/static/` + ES modules under `tqdaemon/static/js/`
+- Scheduler tick: `daemon.daemon_tick` — see `tests/test_daemon_tick.py`
+- Docs hub: [docs/README.md](docs/README.md)
+
+Do not assume a sibling `devkit` or shared inbox layout; this repository is standalone for public users.

tqdaemon-0.8.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,5 @@
+# Code of Conduct
+
+Be respectful in issues, discussions, and PRs. Harassment, spam, or deliberate sabotage of the project or its users is not welcome. Maintainers may moderate or ban accounts that violate this standard.
+
+This project follows the spirit of the [Contributor Covenant](https://www.contributor-covenant.org/) v2.1.

tqdaemon-0.8.0/CONTRIBUTING.md

@@ -0,0 +1,28 @@
+# Contributing
+
+## Setup
+
+```text
+git clone https://github.com/wwylon/tqdaemon.git
+cd tqdaemon
+uv sync --group dev
+uv run tq doctor
+```
+
+## Tests
+
+```text
+uv run ruff check tqdaemon/ tests/
+uv run pytest -q -m "not stress"
+uv run python scripts/build_docs.py --check
+```
+
+## Pull requests
+
+- Open PRs against the public repository.
+- Link an issue when fixing a bug; include `tq doctor` / OS / version for runtime problems.
+- Maintainers may replay accepted changes through an internal mirror; your commits can appear rewritten in the next public export. Attribution is preserved in CHANGELOG / PR comments when practical.
+
+## Security
+
+See [SECURITY.md](SECURITY.md). Do not file vulnerabilities in public issues.

tqdaemon-0.8.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 tqdaemon contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tqdaemon-0.8.0/PKG-INFO

@@ -0,0 +1,96 @@
+Metadata-Version: 2.5
+Name: tqdaemon
+Version: 0.8.0
+Summary: Local resource-aware task queue daemon (CLI, web UI, MCP, remote workers)
+Project-URL: Homepage, https://github.com/wwylon/tqdaemon
+Project-URL: Repository, https://github.com/wwylon/tqdaemon
+Project-URL: Issues, https://github.com/wwylon/tqdaemon/issues
+Project-URL: Documentation, https://github.com/wwylon/tqdaemon/tree/main/docs
+Author: tqdaemon contributors
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai-agents,cli,daemon,gpu,job-scheduler,local-first,mcp,resource-management,task-queue,web-ui,yaml
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.12
+Requires-Dist: nvidia-ml-py>=12.0
+Requires-Dist: psutil>=5.9
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: toast
+Requires-Dist: winotify>=1.1.0; extra == 'toast'
+Description-Content-Type: text/markdown
+
+# tqdaemon
+
+[English](README.md) | [Polski](README.pl.md) | [中文](README.zh.md) | [العربية](README.ar.md)
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
+[![CI](https://github.com/wwylon/tqdaemon/actions/workflows/ci.yml/badge.svg)](https://github.com/wwylon/tqdaemon/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/tqdaemon)](https://pypi.org/project/tqdaemon/)
+[![Latest tag](https://img.shields.io/github/v/tag/wwylon/tqdaemon?label=version)](https://github.com/wwylon/tqdaemon/tags)
+
+![tqdaemon — local jobs, agents, workers](https://raw.githubusercontent.com/wwylon/tqdaemon/main/docs/assets/demo.gif)
+
+**tqdaemon** runs long jobs on your own machines without melting them.
+Describe each job in YAML. A local **daemon** starts work only when there is
+enough CPU, RAM, and GPU memory. Watch progress in a **web UI**, the **`tq`**
+CLI, or from an **AI coding agent** (MCP).
+
+Not Celery, Kubernetes, or CI. Not the 2011 AMQP/Debian
+[rojkov/taskqueue](https://github.com/rojkov/taskqueue) (simpletaskqueue).
+
+## Why use it
+
+- Resource-aware admission (CPU / RAM / GPU VRAM) on one PC or with remote workers
+- YAML jobs with checkpoints, deps, priorities, and stable error codes
+- Built for **agents**: submit, wait, diagnose over MCP
+- Local-first — no cloud SaaS account
+
+## Best start: ask your agent
+
+Tell your coding agent (Cursor, Claude Code, …) to use **tqdaemon** for long
+jobs: wire MCP (`tq mcp`), submit YAML tasks, and `wait_for_task` instead of
+blocking the chat. Setup: **[docs/mcp.md](docs/mcp.md)**.
+
+## Install
+
+**Need:** Python **3.12+**, [Git](https://git-scm.com/), [`uv`](https://docs.astral.sh/uv/).
+
+**From PyPI:** `uvx --from tqdaemon tq doctor` (or `pipx install tqdaemon`). From source:
+
+```powershell
+git clone https://github.com/wwylon/tqdaemon.git
+cd tqdaemon
+uv sync
+uv run tq doctor
+uv run tq start
+```
+
+Open **http://127.0.0.1:8765**. Try the sample in
+[`examples/minimal`](examples/minimal/) (register it as a project, then
+`tq sync` / enable / `tq wait` — see that folder’s README).
+
+Optional Windows toasts: `uv sync --extra toast`. Autostart:
+`scripts/install_tq_autostart.ps1`.
+
+## Docs
+
+| Audience | Start here |
+|----------|------------|
+| Humans | [docs/README.md](docs/README.md) · [Quickstart](docs/operators/quickstart.md) · [Web UI](docs/operators/web-ui.md) · [CLI](docs/operators/cli.md) |
+| Agents | [AGENTS.md](AGENTS.md) · [MCP](docs/mcp.md) · [Cookbook](docs/agents/task-script-cookbook.md) · [llms.txt](llms.txt) |
+
+**Advanced:** [Security & privacy](docs/security.md) · [Task standards](docs/task_standards.md) · [Scheduler](docs/scheduler.md) · [Workers](docs/WORKER_SETUP.md)
+
+## Transparency
+
+We do **not** phone home. Public signals are GitHub stars (badge above) and,
+after a PyPI release under a distinct package name, download counts you can
+verify yourself. Maintainers may use GitHub Traffic Insights (clones ≠ installs).
+Details: [docs/security.md](docs/security.md#privacy--telemetry).
+
+## License
+
+MIT — see [LICENSE](LICENSE) · [Changelog](CHANGELOG.md)

tqdaemon-0.8.0/README.ar.md

@@ -0,0 +1,65 @@
+# tqdaemon
+
+[English](README.md) | [Polski](README.pl.md) | [中文](README.zh.md) | [العربية](README.ar.md)
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
+[![CI](https://github.com/wwylon/tqdaemon/actions/workflows/ci.yml/badge.svg)](https://github.com/wwylon/tqdaemon/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/tqdaemon)](https://pypi.org/project/tqdaemon/)
+[![Latest tag](https://img.shields.io/github/v/tag/wwylon/tqdaemon?label=version)](https://github.com/wwylon/tqdaemon/tags)
+
+![tqdaemon — مهام محلية ووكلاء وعمال](https://raw.githubusercontent.com/wwylon/tqdaemon/main/docs/assets/demo.gif)
+
+**tqdaemon** يشغّل المهام الطويلة على أجهزتك دون إنهاكها.
+تصف كل مهمة في YAML. يعمل **daemon** محلي ويبدأ العمل فقط عند توفر
+CPU وRAM وذاكرة GPU كافية. راقب التقدّم عبر **واجهة ويب** أو CLI **`tq`**
+أو وكيل ترميز بالذكاء الاصطناعي (**MCP**).
+
+ليس Celery أو Kubernetes أو CI. وليس مشروع AMQP/Debian القديم من 2011
+[rojkov/taskqueue](https://github.com/rojkov/taskqueue) (simpletaskqueue).
+
+## لماذا
+
+- قبول المهام حسب الموارد (CPU / RAM / GPU) محلياً أو على عمال بعُدين
+- YAML مع نقاط حفظ وتبعيات وأولويات ورموز أخطاء مستقرة
+- مخصّص للوكلاء: إرسال وانتظار وتشخيص عبر MCP
+- محلي أولاً — بلا حساب SaaS سحابي
+
+## أفضل بداية: اطلب من الوكيل
+
+اطلب من وكيلك (Cursor أو Claude Code وغيرهما) استخدام **tqdaemon** للمهام
+الطويلة: إعداد MCP (`tq mcp`) وإرسال YAML و`wait_for_task` بدل حجب المحادثة.
+الإعداد: **[docs/mcp.md](docs/mcp.md)**.
+
+## التثبيت
+
+**المتطلبات:** Python **3.12+** و[Git](https://git-scm.com/) و[`uv`](https://docs.astral.sh/uv/).
+
+```powershell
+git clone https://github.com/wwylon/tqdaemon.git
+cd tqdaemon
+uv sync
+uv run tq doctor
+uv run tq start
+```
+
+افتح **http://127.0.0.1:8765**. مثال:
+[`examples/minimal`](examples/minimal/).
+
+## التوثيق
+
+| الجمهور | ابدأ من |
+|---------|---------|
+| بشر | [docs/README.md](docs/README.md) · [Quickstart](docs/operators/quickstart.md) · [Web UI](docs/operators/web-ui.md) · [CLI](docs/operators/cli.md) |
+| وكلاء | [AGENTS.md](AGENTS.md) · [MCP](docs/mcp.md) · [Cookbook](docs/agents/task-script-cookbook.md) · [llms.txt](llms.txt) |
+
+**متقدم:** [Security](docs/security.md) · [Task standards](docs/task_standards.md) · [Scheduler](docs/scheduler.md) · [Workers](docs/WORKER_SETUP.md)
+
+## الشفافية
+
+لا نرسل بيانات استخدام خفية. الإشارات العامة: نجوم GitHub؛ وبعد نشر PyPI
+عدادات التحميل العامة. التفاصيل: [docs/security.md](docs/security.md#privacy--telemetry).
+
+## الرخصة
+
+MIT — [LICENSE](LICENSE) · [Changelog](CHANGELOG.md)

tqdaemon-0.8.0/README.md

@@ -0,0 +1,73 @@
+# tqdaemon
+
+[English](README.md) | [Polski](README.pl.md) | [中文](README.zh.md) | [العربية](README.ar.md)
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
+[![CI](https://github.com/wwylon/tqdaemon/actions/workflows/ci.yml/badge.svg)](https://github.com/wwylon/tqdaemon/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/tqdaemon)](https://pypi.org/project/tqdaemon/)
+[![Latest tag](https://img.shields.io/github/v/tag/wwylon/tqdaemon?label=version)](https://github.com/wwylon/tqdaemon/tags)
+
+![tqdaemon — local jobs, agents, workers](https://raw.githubusercontent.com/wwylon/tqdaemon/main/docs/assets/demo.gif)
+
+**tqdaemon** runs long jobs on your own machines without melting them.
+Describe each job in YAML. A local **daemon** starts work only when there is
+enough CPU, RAM, and GPU memory. Watch progress in a **web UI**, the **`tq`**
+CLI, or from an **AI coding agent** (MCP).
+
+Not Celery, Kubernetes, or CI. Not the 2011 AMQP/Debian
+[rojkov/taskqueue](https://github.com/rojkov/taskqueue) (simpletaskqueue).
+
+## Why use it
+
+- Resource-aware admission (CPU / RAM / GPU VRAM) on one PC or with remote workers
+- YAML jobs with checkpoints, deps, priorities, and stable error codes
+- Built for **agents**: submit, wait, diagnose over MCP
+- Local-first — no cloud SaaS account
+
+## Best start: ask your agent
+
+Tell your coding agent (Cursor, Claude Code, …) to use **tqdaemon** for long
+jobs: wire MCP (`tq mcp`), submit YAML tasks, and `wait_for_task` instead of
+blocking the chat. Setup: **[docs/mcp.md](docs/mcp.md)**.
+
+## Install
+
+**Need:** Python **3.12+**, [Git](https://git-scm.com/), [`uv`](https://docs.astral.sh/uv/).
+
+**From PyPI:** `uvx --from tqdaemon tq doctor` (or `pipx install tqdaemon`). From source:
+
+```powershell
+git clone https://github.com/wwylon/tqdaemon.git
+cd tqdaemon
+uv sync
+uv run tq doctor
+uv run tq start
+```
+
+Open **http://127.0.0.1:8765**. Try the sample in
+[`examples/minimal`](examples/minimal/) (register it as a project, then
+`tq sync` / enable / `tq wait` — see that folder’s README).
+
+Optional Windows toasts: `uv sync --extra toast`. Autostart:
+`scripts/install_tq_autostart.ps1`.
+
+## Docs
+
+| Audience | Start here |
+|----------|------------|
+| Humans | [docs/README.md](docs/README.md) · [Quickstart](docs/operators/quickstart.md) · [Web UI](docs/operators/web-ui.md) · [CLI](docs/operators/cli.md) |
+| Agents | [AGENTS.md](AGENTS.md) · [MCP](docs/mcp.md) · [Cookbook](docs/agents/task-script-cookbook.md) · [llms.txt](llms.txt) |
+
+**Advanced:** [Security & privacy](docs/security.md) · [Task standards](docs/task_standards.md) · [Scheduler](docs/scheduler.md) · [Workers](docs/WORKER_SETUP.md)
+
+## Transparency
+
+We do **not** phone home. Public signals are GitHub stars (badge above) and,
+after a PyPI release under a distinct package name, download counts you can
+verify yourself. Maintainers may use GitHub Traffic Insights (clones ≠ installs).
+Details: [docs/security.md](docs/security.md#privacy--telemetry).
+
+## License
+
+MIT — see [LICENSE](LICENSE) · [Changelog](CHANGELOG.md)

tqdaemon-0.8.0/README.pl.md

@@ -0,0 +1,65 @@
+# tqdaemon
+
+[English](README.md) | [Polski](README.pl.md) | [中文](README.zh.md) | [العربية](README.ar.md)
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
+[![CI](https://github.com/wwylon/tqdaemon/actions/workflows/ci.yml/badge.svg)](https://github.com/wwylon/tqdaemon/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/tqdaemon)](https://pypi.org/project/tqdaemon/)
+[![Latest tag](https://img.shields.io/github/v/tag/wwylon/tqdaemon?label=version)](https://github.com/wwylon/tqdaemon/tags)
+
+![tqdaemon — lokalne zadania, agenci, workery](https://raw.githubusercontent.com/wwylon/tqdaemon/main/docs/assets/demo.gif)
+
+**tqdaemon** uruchamia długie zadania na Twoich komputerach, nie przeciążając
+ich. Opisujesz job w YAML. Lokalny **daemon** startuje pracę tylko gdy jest
+wystarczająco CPU, RAM i pamięci GPU. Postęp śledzisz w **UI**, CLI **`tq`**
+lub przez agenta AI (**MCP**).
+
+To nie Celery, Kubernetes ani CI. To też nie stary projekt AMQP/Debian
+[rojkov/taskqueue](https://github.com/rojkov/taskqueue) (simpletaskqueue).
+
+## Po co
+
+- Przyjmowanie zadań według zasobów (CPU / RAM / GPU) lokalnie lub na workerach
+- YAML: checkpointy, zależności, priorytety, stabilne kody błędów
+- Pod agentów: submit / wait / diagnose przez MCP
+- Lokalnie — bez konta w chmurze SaaS
+
+## Najlepszy start: poproś agenta
+
+Powiedz agentowi (Cursor, Claude Code, …), żeby używał **tqdaemon** do długich
+jobów: MCP (`tq mcp`), YAML i `wait_for_task` zamiast blokować czat.
+Setup: **[docs/mcp.md](docs/mcp.md)**.
+
+## Instalacja
+
+**Wymagania:** Python **3.12+**, [Git](https://git-scm.com/), [`uv`](https://docs.astral.sh/uv/).
+
+```powershell
+git clone https://github.com/wwylon/tqdaemon.git
+cd tqdaemon
+uv sync
+uv run tq doctor
+uv run tq start
+```
+
+Otwórz **http://127.0.0.1:8765**. Przykład:
+[`examples/minimal`](examples/minimal/).
+
+## Dokumentacja
+
+| Dla | Start |
+|-----|--------|
+| Ludzie | [docs/README.md](docs/README.md) · [Quickstart](docs/operators/quickstart.md) · [Web UI](docs/operators/web-ui.md) · [CLI](docs/operators/cli.md) |
+| Agenci | [AGENTS.md](AGENTS.md) · [MCP](docs/mcp.md) · [Cookbook](docs/agents/task-script-cookbook.md) · [llms.txt](llms.txt) |
+
+**Zaawansowane:** [Security](docs/security.md) · [Task standards](docs/task_standards.md) · [Scheduler](docs/scheduler.md) · [Workers](docs/WORKER_SETUP.md)
+
+## Przejrzystość
+
+Nie wysyłamy telemetrii. Publiczne sygnały: gwiazdki GitHub; po publikacji na
+PyPI — liczniki pobrań. Szczegóły: [docs/security.md](docs/security.md#privacy--telemetry).
+
+## Licencja
+
+MIT — [LICENSE](LICENSE) · [Changelog](CHANGELOG.md)