Skip to main content

kiwiMe web host

Run kiwiMe as a local web app — a background service on 127.0.0.1 plus a browser UI — instead of the Tauri desktop shell. This is the primary distribution for developers and technical users (no code signing, no native installer): you start a service and open a browser.

It is local-first: the service binds to loopback only, and all data (credentials, content, indexes) stays on your machine, exactly as in the desktop app. The host runs every sidecar in-process — there are no child processes and no stdio plumbing; see docs/release/webification-plan.md.

Run from a checkout (current)

Prerequisites:

  • uv (Python package manager)
  • Node ≥ 20 and pnpm — the easiest way to get pnpm is corepack enable (ships with Node), or npm install -g pnpm.
  • Python ≥ 3.11 with SQLite loadable-extension support (standard CPython builds have it).
# 1. install the Python workspace (all sidecars + the host)
uv sync --all-packages -p 3.12

# 2. build the frontend once (served as static files by the host)
cd apps/desktop && pnpm install && pnpm build && cd -

# 3. start the host — opens http://127.0.0.1:8765 in your browser
uv run kiwime

If you skip step 2, the host still starts and serves the API, and shows a "UI not built" page with these instructions instead of the app.

Options:

kiwime [--host 127.0.0.1] [--port 8765] [--db PATH] [--no-browser]
  • --db PATH — use a specific store SQLite file (default: the platform app data dir, the same one the desktop app uses).
  • --no-browser — don't auto-open a browser. The startup log prints an authenticated …/auth?token=… link — open that (or use the token as an Authorization: Bearer header for scripting).
  • KIWIME_DIST=/path/to/dist — override where the built UI is served from.

Security

The API requires a per-session token even on loopback: the browser gets it via the /auth?token=… link (exchanged for an HttpOnly cookie), other clients pass Authorization: Bearer <token>. Requests with a non-localhost Host header or a non-JSON body are rejected. A fresh token is minted on every start.

Linux note

Connector credentials go to the OS keyring. On Linux this needs a Secret Service provider (GNOME Keyring / KWallet via libsecret); on a headless box or minimal WSL distro, install gnome-keyring (or configure another keyring backend) before adding sources.

Local models

The host exposes the same one-click Ollama flow as the desktop app (detect / download with progress). Install Ollama and use the in-app model manager to pull Qwen3 / Gemma 3. The curated model list lives in shared/model-catalog.json, shared with the desktop runtime.

Installing as a tool (future)

pipx install kiwime / uv tool install kiwime will be the one-line install once the packages are published to PyPI and the built UI is bundled into the wheel. Until then, use the checkout flow above.

How it relates to the desktop app

The React frontend and all Python sidecars are shared. Only the host differs: the desktop app uses a Rust (Tauri) shell that spawns sidecars as processes; this web host holds them in one Python process and serves the same UI over HTTP + SSE. apps/desktop/src/api/tauri.ts picks the transport at runtime.

Metadata

Release files for kiwime 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for kiwime 0.1.0
File Size Uploaded Provenance Actions
kiwime-0.1.0.tar.gz 310.1 kB Without provenance Details for kiwime-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for kiwime 0.1.0
File Interpreter ABI Platform Actions
kiwime-0.1.0-py3-none-any.whl Python 3 none any Details for kiwime-0.1.0-py3-none-any.whl

Total release size: 623.6 kB

Release files / kiwime-0.1.0.tar.gz

Download URL kiwime-0.1.0.tar.gz
Size 310.1 kB
Tags Source
SHA-256 checksum
How to use checksums
774bad0149f0857bb78b12379e8996f7e6dcc2eaeb9458d276b580741ce99955
BLAKE2b-256 checksum
How to use checksums
2291847d97cabf80d8996625105bec3e339f9de6142d6710f9df552504bc5728
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.28 {"installer":{"name":"uv","version":"0.11.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / kiwime-0.1.0-py3-none-any.whl

Download URL kiwime-0.1.0-py3-none-any.whl
Size 313.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6e6d361f771671caeaf730eb629d7f327f26d7cd7db254d5597552f7ae3f9e22
BLAKE2b-256 checksum
How to use checksums
886ff174d6d4db687b11ab424d426242e4fe58b2ff9277d33e7b032b9c26f9c4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.28 {"installer":{"name":"uv","version":"0.11.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for kiwime 0.1.0

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.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

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