kritapilot 1.0.0__tar.gz

kritapilot-1.0.0/.gitattributes

@@ -0,0 +1,3 @@
+* text=auto
+*.png binary
+*.zip binary

kritapilot-1.0.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,58 @@
+name: Bug report
+description: Something doesn't work as it should
+labels: [bug]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting! The more of this you fill in, the faster it can be fixed.
+        Security problems: please don't post them here - see SECURITY.md.
+  - type: textarea
+    id: what
+    attributes:
+      label: What happened
+      description: What you did (or asked the AI), what you expected, and what happened instead.
+      placeholder: |
+        I asked the AI Chat (provider: Auto) to "paint a sunset over mountains".
+        Expected: a painting. Instead: ...
+    validations:
+      required: true
+  - type: input
+    id: versions
+    attributes:
+      label: Versions
+      description: Krita, the plugin and the server. The AI Bridge (MCP) panel shows them; or run `kritapilot --version`.
+      placeholder: Krita 5.3.4, plugin 2026.11.8.35, server 2026.11.8.35
+    validations:
+      required: true
+  - type: dropdown
+    id: where
+    attributes:
+      label: Where
+      multiple: true
+      options:
+        - AI Chat inside Krita
+        - An MCP client (Claude, ChatGPT, Cursor, ...)
+        - The AI Bridge (MCP) panel
+        - Installing or updating
+        - Image or video generation
+        - Something else
+  - type: input
+    id: os
+    attributes:
+      label: Operating system
+      placeholder: Windows 11 / macOS 15 / Ubuntu 24.04
+  - type: textarea
+    id: logs
+    attributes:
+      label: Log lines
+      description: |
+        Open **Logs…** (in the AI Chat or AI Bridge panel), type ✗ in the filter to see only failures, and paste
+        the lines around the problem. Keys are masked in the logs, so they are safe to share.
+        If Krita froze, attach `~/.kritapilot/hang.log` too.
+      render: text
+  - type: textarea
+    id: extra
+    attributes:
+      label: Anything else
+      description: Screenshots, the prompt you used, the provider and model, ...

kritapilot-1.0.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,11 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Installation and first steps
+    url: https://github.com/jowinjohnchemban/kritapilot/blob/main/docs/installation.md
+    about: Installing the plugin and the server, and connecting an AI client.
+  - name: AI Chat inside Krita
+    url: https://github.com/jowinjohnchemban/kritapilot/blob/main/docs/ai-chat.md
+    about: Providers, Auto, free services, skills and settings.
+  - name: Report a security problem privately
+    url: https://github.com/jowinjohnchemban/kritapilot/security/advisories/new
+    about: Please don't post security problems in public issues.

kritapilot-1.0.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,31 @@
+name: Idea or feature request
+description: Something the AI should be able to do in Krita, a service to support, or a better way of working
+labels: [enhancement]
+body:
+  - type: textarea
+    id: idea
+    attributes:
+      label: What would you like to do?
+      description: Describe it as an artist or user would - what you want to make or change, not how to build it.
+      placeholder: I'd like to ask the AI to turn my sketch layer into a coloured comic panel ...
+    validations:
+      required: true
+  - type: textarea
+    id: today
+    attributes:
+      label: What happens today?
+      description: How you do it now, or what goes wrong when you try.
+  - type: dropdown
+    id: area
+    attributes:
+      label: Area
+      multiple: true
+      options:
+        - Painting and drawing
+        - Photo editing
+        - Animation and video
+        - Image or video generation
+        - AI Chat inside Krita
+        - A new AI service or model provider
+        - A new skill
+        - Something else

kritapilot-1.0.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,13 @@
+## What this changes
+
+<!-- What and why, in a few sentences. Link the issue it fixes, if any (Fixes #123). -->
+
+## How it was tested
+
+- [ ] `pytest` (PyQt6) and `KRITA_TEST_QT=5 pytest` (PyQt5) pass
+- [ ] Plugin changes: `python scripts/smoke_krita.py` passes against a real Krita
+- [ ] New or changed tools: `python scripts/gen_tool_docs.py` run, `docs/tools.md` updated
+
+## Notes for the reviewer
+
+<!-- Anything that needs a closer look, screenshots of UI changes, follow-ups. -->

kritapilot-1.0.0/.github/workflows/ci.yml

@@ -0,0 +1,53 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: test (${{ matrix.os }}, py${{ matrix.python }}, ${{ matrix.qt }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+        python: ["3.10", "3.13"]
+        qt: [PyQt6, PyQt5]
+    env:
+      QT_QPA_PLATFORM: offscreen
+      KRITA_TEST_QT: ${{ matrix.qt == 'PyQt5' && '5' || '6' }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python }}
+          cache: pip
+      - name: System libraries for headless Qt
+        if: runner.os == 'Linux'
+        run: sudo apt-get update && sudo apt-get install -y libegl1 libgl1 libxkbcommon0 libfontconfig1 libdbus-1-3
+      - name: Install
+        run: python -m pip install -e ".[test]" ${{ matrix.qt }} pyflakes
+      - name: Lint
+        run: python -m pyflakes src scripts tests plugin
+      - name: Tests
+        run: python -m pytest -q
+
+  plugin:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Build plugin zip
+        run: python scripts/build_plugin.py --out dist
+      - uses: actions/upload-artifact@v4
+        with:
+          name: krita-plugin
+          path: dist/*.zip

kritapilot-1.0.0/.github/workflows/release.yml

@@ -0,0 +1,151 @@
+#
+# Publish KritaPilot on every push to main: the Krita plugin zip and the server's wheel and sdist go to a GitHub
+# release, and the wheel and sdist to PyPI (https://pypi.org/p/kritapilot).
+#
+# Jobs, as in PyPA's guide (https://packaging.python.org/en/latest/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows/):
+#   build           next version, test, build everything once and keep it as the "dist" artifact
+#   github-release  publish the artifact as a GitHub release (the plugin and the server update from there)
+#   pypi            upload the wheel and sdist with PyPI trusted publishing - no password or token is stored
+#
+# Versions are SemVer and count up by one: MAJOR.MINOR from pyproject.toml, PATCH one more than the highest already
+# published (GitHub or PyPI). The tag is vX.Y.Z and official names use only the version. Each build also has a
+# build id, the build date and commit (YYYYMMDD-COMMIT), shown in the release notes and the app. Nothing is committed.
+#
+
+name: Release
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+concurrency:
+  group: release
+  cancel-in-progress: true  # a newer push supersedes a release still being built
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    permissions:
+      contents: read
+    outputs:
+      version: ${{ steps.version.outputs.version }}
+      build: ${{ steps.version.outputs.build }}
+      commit: ${{ steps.version.outputs.commit }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install
+        run: |
+          sudo apt-get update && sudo apt-get install -y libegl1 libgl1 libxkbcommon0 libfontconfig1 libdbus-1-3
+          python -m pip install -e ".[test]" PyQt6 build twine
+
+      - name: Next version, build id and commit (stamped in this build only)
+        id: version
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: python scripts/release_version.py --repo "${{ github.repository }}" --sha "$GITHUB_SHA" >> "$GITHUB_OUTPUT"
+
+      - name: Test
+        env:
+          QT_QPA_PLATFORM: offscreen
+        run: python -m pytest -q
+
+      - name: Build plugin zip, wheel and sdist
+        run: |
+          python scripts/build_plugin.py --out dist
+          python -m build --outdir dist
+          python -m twine check --strict dist/*.whl dist/*.tar.gz
+          {
+            echo "## 📦 KritaPilot ${{ steps.version.outputs.version }} (build ${{ steps.version.outputs.build }})"
+            echo
+            ls -lh dist | awk 'NR>1 {print "- **" $9 "**: " $5}'
+          } >> "$GITHUB_STEP_SUMMARY"
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/*
+
+  github-release:
+    needs: build
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    permissions:
+      contents: write
+      actions: write
+    env:
+      VERSION: ${{ needs.build.outputs.version }}
+      BUILD_ID: ${{ needs.build.outputs.build }}
+      COMMIT: ${{ needs.build.outputs.commit }}
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist
+
+      - name: Create the GitHub release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: v${{ env.VERSION }}
+          target_commitish: ${{ github.sha }}
+          name: KritaPilot ${{ env.VERSION }}
+          make_latest: true
+          generate_release_notes: true
+          body: |
+            Version **${{ env.VERSION }}** · build `${{ env.BUILD_ID }}` ([commit](https://github.com/${{ github.repository }}/commit/${{ github.sha }}))
+
+            ## Install
+
+            **Server** (the Krita MCP server and the AI Chat assistant), from PyPI or from GitHub:
+
+            ```bash
+            pip install kritapilot==${{ env.VERSION }}
+            pip install "git+https://github.com/${{ github.repository }}@v${{ env.VERSION }}"
+            ```
+
+            **Krita plugin**: download `kritapilot-plugin-${{ env.VERSION }}.zip` below, then in Krita choose *Tools >
+            Scripts > Import Python Plugin from File...*, pick the zip, enable it and restart Krita. Open *Settings >
+            Dockers > AI Chat* or *AI Bridge (MCP)*.
+
+            Already installed? The plugin and the server update themselves.
+
+            Docs: https://github.com/${{ github.repository }}/tree/main/docs · Changes: [CHANGELOG.md](https://github.com/${{ github.repository }}/blob/main/CHANGELOG.md)
+          files: dist/*
+          fail_on_unmatched_files: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Delete old workflow runs
+        uses: Mattraks/delete-workflow-runs@v2
+        with:
+          retain_days: 7
+          keep_minimum_runs: 2
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  pypi:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    environment:
+      name: pypi
+      url: https://pypi.org/p/kritapilot
+    permissions:
+      id-token: write  # trusted publishing: PyPI checks this workflow's identity instead of a stored token
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist
+
+      - name: Keep only the Python packages
+        run: rm -f dist/*.zip
+
+      - uses: pypa/gh-action-pypi-publish@release/v1

kritapilot-1.0.0/.gitignore

@@ -0,0 +1,19 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.venv/
+venv/
+build/
+dist/
+.pytest_cache/
+
+# Local smoke-test output
+smoke_out/
+
+# Editors / OS
+.vscode/
+.idea/
+Thumbs.db
+.DS_Store
+dist/

kritapilot-1.0.0/CHANGELOG.md

@@ -0,0 +1,61 @@
+# Changelog
+
+Releases are published automatically from `main` with [SemVer](https://semver.org) versions that count up by one
+(see [releases](https://github.com/jowinjohnchemban/kritapilot/releases) and [PyPI](https://pypi.org/p/kritapilot)).
+The plugin and the server update themselves. This file lists what changed, newest first.
+
+## 2026-11-08
+
+**New name: KritaPilot** (formerly *krita-mcp*). The project is more than an MCP server now, so it has a name of its own: the repository is `jowinjohnchemban/kritapilot`, the package is [`kritapilot` on PyPI](https://pypi.org/p/kritapilot) and the command is `kritapilot`. Versions are SemVer from 1.0.0 and count up by one with each release.
+
+**AI Chat**
+- **Auto - all my providers** is the default: it uses the providers you signed in to or set up, then the
+  free ones, and when one runs out of credit, hits a quota, rejects its key or stops answering, the next
+  one carries on with the same task (with a recap of what was done).
+- The provider menu always lists what you can use now; every other provider is one pick away and opens
+  its setup.
+- Services are set up the way each one works: an API key, a browser sign-in, a server address with
+  **Test connection**, or nothing at all for the free ones. Sign out, Change key, Turn on and Turn off work
+  at once.
+- A chat like a coding assistant's: Enter sends, Shift+Enter adds a line, Up recalls; messages typed while
+  the AI works are queued; your message shows at once; a status line says what the AI is doing.
+- A model answer may take at most three minutes; models that cannot see pictures get text instead; an
+  image service the AI invents is replaced by one you have; AI Horde makes at most two variations, each
+  with its own seed.
+
+**Reliability**
+- A freeze watchdog: if Krita is ever frozen for a minute, every thread's stack goes to
+  `~/.kritapilot/hang.log`.
+- Fixed: the Send button, a panel that could stop updating while a dialog was open, and skills meant for
+  coding assistants being offered to the painting assistant.
+
+## 2026-11-07
+
+**AI Chat**
+- Free providers with no sign-in (Pollinations, Kilo Gateway, OVHcloud, LLM7, OmniRoute) and free image
+  services (Pollinations, AI Horde).
+- 39 built-in skills, found and loaded only when a request needs them.
+- Fewer tokens per step (older pictures dropped, prompt caching, repeated errors stop), and the cost of
+  each answer shown.
+- Stop works at once; retries when a model service is briefly down; readable errors.
+- **Logs…**: every command, chat step, setting change and error, live, with keys masked.
+
+**Krita**
+- Fixed the "Waiting for image operation to complete… Scripted Brush Stroke" freeze.
+- Popups Krita opens while the AI works (such as "Missing Colour Profile") are cancelled and reported to
+  the AI instead of blocking it.
+- Copy or cut to a new layer no longer goes through your clipboard.
+- Over-the-air updates for the plugin and the server, checked against GitHub's checksums.
+
+## 2026-11-06
+
+First public version:
+- 86 MCP tools: real brushes, shapes, vectors and text; layers, masks and selections; photo adjustments
+  and filters; animation and video; seeing and measuring the canvas; undo for AI edits.
+- Generative AI on the canvas: ComfyUI, AUTOMATIC1111/Forge, OpenAI, Gemini, Stability, Replicate and
+  fal.ai for images; Sora, Veo, HeyGen, Replicate and fal for video; vision models for a second opinion.
+- `create_artwork`: one prompt, generated or painted by hand.
+- The AI Chat docker inside Krita with browser sign-in for OpenRouter and live model lists from each
+  provider.
+- The AI Bridge panel: status, access modes (full, read-only, paused), workspace, token and client
+  snippets.

kritapilot-1.0.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,25 @@
+# Code of conduct
+
+This project welcomes everyone: artists, developers, beginners and experts, whatever their background.
+
+## Expected
+
+- Be kind and patient, especially with people who are new to Krita, AI or open source.
+- Assume good intent, and give and take feedback about the work, not the person.
+- Keep discussions on topic and useful to others who read them later.
+
+## Not accepted
+
+- Harassment, insults, or discriminatory jokes and language.
+- Personal attacks, trolling, or deliberately derailing discussions.
+- Publishing someone's private information, or sexual or violent content aimed at anyone.
+- Using the project to create or share content that violates other people's rights or the law.
+
+## Enforcement
+
+Maintainers may edit or remove comments, issues and contributions that break these rules, and may block
+people who repeatedly do. To report a problem, contact a maintainer privately through GitHub (for example
+by [reporting the content](https://docs.github.com/en/communities/maintaining-your-safety-on-github/reporting-abuse-or-spam)
+or the user). Reports are handled confidentially.
+
+This code is adapted from the [Contributor Covenant](https://www.contributor-covenant.org/), version 2.1.

kritapilot-1.0.0/CONTRIBUTING.md

@@ -0,0 +1,60 @@
+# Contributing
+
+Thanks for helping. Bug reports, ideas, new skills, docs fixes and code are all welcome.
+
+## Reporting a bug
+
+Open an [issue](https://github.com/jowinjohnchemban/kritapilot/issues/new/choose) and include:
+
+- the versions: Krita, the plugin and the server (the **AI Bridge (MCP)** panel shows them, or run
+  `kritapilot --version`);
+- what you asked the AI and what happened instead;
+- the relevant lines from **Logs…** (in the AI Chat or AI Bridge panel). Keys are masked, so the text is
+  safe to paste. **Copy** copies what the window shows; type `✗` in its filter to see only failures;
+- if Krita froze: `~/.kritapilot/hang.log`.
+
+Security problems: please don't open a public issue; see [SECURITY.md](SECURITY.md).
+
+## Setting up
+
+```bash
+git clone https://github.com/jowinjohnchemban/kritapilot
+cd KritaPilot
+python -m venv .venv && . .venv/bin/activate      # Windows: .venv\Scripts\activate
+pip install -e ".[test]" PyQt6 PyQt5
+python scripts/install_plugin.py                   # copy the plugin into Krita, then restart Krita
+```
+
+## Tests
+
+```bash
+QT_QPA_PLATFORM=offscreen pytest                   # PyQt6 (Krita 6 code path)
+KRITA_TEST_QT=5 QT_QPA_PLATFORM=offscreen pytest   # PyQt5 (Krita 5 code path)
+python scripts/smoke_krita.py                      # against a running Krita: 56 end-to-end checks
+```
+
+CI runs the unit tests on Linux and Windows with both PyQt versions. CI cannot run Krita, so for changes
+to the plugin, please run the smoke test against a real Krita too.
+
+## Making a change
+
+- Keep a change focused, with tests for what it fixes or adds.
+- New tool: see [Adding a tool](docs/development.md#adding-a-tool). Run `python scripts/gen_tool_docs.py`
+  so `docs/tools.md` stays current (a test checks it).
+- New skill: add a folder with a `SKILL.md` under `src/kritapilot/bundled_skills/` (a name, a one-line
+  description, then the steps). Name only tools that exist; a test checks that too.
+- New AI service: most are OpenAI-compatible and need one line in
+  `src/kritapilot/providers/compat.py`. See [Connecting AI services](docs/ai-backends.md).
+- Write docs and messages in plain words for artists, not developers.
+- The plugin runs inside Krita on its main thread: never block it (network calls go to a worker thread).
+  Never add a way for the AI to run code, and never log or show API keys.
+
+The project layout and Krita API notes are in [docs/development.md](docs/development.md).
+
+## Pull requests
+
+Describe what changed and how you tested it. A maintainer reviews it, and once it is merged into `main`,
+it ships in the next release automatically.
+
+By contributing you agree that your work is released under the [MIT licence](LICENSE), and to follow the
+[code of conduct](CODE_OF_CONDUCT.md).

kritapilot-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 krita-mcp 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.