This release is a pre-release and may not be stable for production use.
[!WARNING] KToolBox v1 is a new major version and has not yet received enough real-world validation. Some features may still fail. Please report anything unexpected.
Kemono is no longer available, so KToolBox now uses the Pawchive mirror by default.
Start with the WebUI
The WebUI is the recommended way to use KToolBox. It covers downloads, creator synchronization, automatic schedules, naming, filters, progress, and project configuration without requiring you to edit commands or configuration files first.
-
Install KToolBox with the WebUI:
pipx install "ktoolbox[webui]"
-
Create a project directory and start it:
mkdir ktoolbox-project cd ktoolbox-project ktoolbox webui .
-
The browser opens automatically. Sign in with the username and random password printed in the terminal.
-
Add creators on Creators, then create a synchronization or download task on Tasks.
KToolBox creates ktoolbox.toml when it is missing and downloads to the project's downloads directory by default.
Read the short WebUI guide for the next steps, or open the documentation home to choose a specific workflow.
What the WebUI includes
- Single-work downloads and concurrent synchronization of many creators.
- A reusable creator roster, filters, naming templates, and automatic synchronization plans.
- Persistent task history, live progress, aggregate speed, retries, pause, stop, rerun, and safe cleanup.
- Project-level settings with readable descriptions and filesystem pickers where appropriate.
- Seven interface languages, responsive layouts, light and dark themes, and optional NSFW media previews.
- A built-in MCP service for Codex, Claude, Cursor, VS Code, and compatible clients.
Optional setup
The generated login is convenient for a first run. For a stable password, generate a hash and add it to the project's .env:
ktoolbox webui hash-password
KTOOLBOX_WEBUI__USERNAME=owner
KTOOLBOX_WEBUI__PASSWORD_HASH='$argon2id$...'
For local-only access, start with --host 127.0.0.1. The built-in server uses HTTP, so use a trusted network or an HTTPS reverse proxy for remote access.
Advanced use
The command line remains available for scripts and terminal workflows:
ktoolbox download https://pawchive.pw/fanbox/user/6570768/post/1836570
ktoolbox sync fanbox:123 patreon:456 --length 10
See the CLI guide for commands, the MCP guide for AI clients, and the Python API guide for integrations.
Upgrading from v0
Back up .env, prod.env, and existing downloads before upgrading. WebUI detects legacy naming settings and guides you through configuration and directory conversion. Read the v1 migration guide before changing an existing project; see troubleshooting if a migration or task fails.
Development
poetry install --with test,docs,dev
poetry run pytest --cov
poetry run mkdocs build --strict
cd webui && npm ci && npm run test && npm run build
Default tests are offline and must not contact Pawchive or any other remote service.
License
KToolBox is licensed under the BSD 3-Clause License.
1 maintainer
Metadata
1 maintainer
Release files for ktoolbox 1.1.0b1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| ktoolbox-1.1.0b1.tar.gz | 917.4 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ktoolbox-1.1.0b1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.9 MB
Release files / ktoolbox-1.1.0b1.tar.gz
| Download URL | ktoolbox-1.1.0b1.tar.gz |
|---|---|
| Size | 917.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b88fd6be041c34ebcc4d2b7ac1e43d3a5e5ed8021adbfcc8b59a40915fb6607f
|
|
BLAKE2b-256 checksum How to use checksums |
fa3e53b4c5d6e90082d8a1549b5d86550e394461786232eba5b02b03877d194a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.4.1 CPython/3.12.3 Linux/6.17.0-1022-azure
|
Release files / ktoolbox-1.1.0b1-py3-none-any.whl
| Download URL | ktoolbox-1.1.0b1-py3-none-any.whl |
|---|---|
| Size | 955.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5f7fb01333b76821b25c346726dbac785c629292d4de90e3e98f32c6c40fdc2e
|
|
BLAKE2b-256 checksum How to use checksums |
84667c0f5e4cc1d040b040e7ad8234ac5c5b39a1de27019df90eed7a1f714195
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.4.1 CPython/3.12.3 Linux/6.17.0-1022-azure
|
Security for ktoolbox 1.1.0b1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
