LiteyukiBot v7

LiteyukiBot v7 is a protocol-neutral chatbot kernel for CPython 3.14. Native plugins run in the core process; NoneBot2 and LiteyukiBot v6 plugins run in supervised child runtimes.

The v7 branch is a clean rewrite. The main branch remains the maintenance line for v6 and is not merged wholesale into v7.

Current Foundation

immutable TOML/JSON configuration with ordered includes, environment overrides, and CLI overrides;
Yukilog 1.x facade backed by Loguru, including structured child logs;
native plugin entry points, async lifecycle hooks, private storage, managed tasks, and versioned services;
bounded protocol-neutral event/action dispatch with per-conversation order;
authenticated framed JSON IPC and supervised subprocess runtimes;
NoneBot2 plugin hosting and a deliberately bounded v6 compatibility shim;
local authenticated CLI control and an optional loopback-only HTTP status API.

Requirements

CPython 3.14+
uv
network access for uv to resolve PyPI dependencies

Yukilog 1.x is installed from PyPI; no sibling checkout is required. The v7 distribution on PyPI is named liteyukibot-v7; Python imports remain liteyukibot and liteyuki for the native and v6 compatibility namespaces.

uv sync --locked
uv run liteyuki check
uv run liteyuki run

Optional integrations are installed explicitly:

uv sync --extra yaml
uv sync --extra http
uv sync --extra nonebot --extra onebot

Use liteyuki.example.toml as a configuration reference. CLI overrides must precede the subcommand, for example:

uv run liteyuki --config local.toml --set logging.level=DEBUG check

Docker

The v7 pre-release image is published to GHCR as ghcr.io/liteyukistudio/liteyukibot:v7.0.0a1. It includes the optional YAML, HTTP, NoneBot2, OneBot, and Satori integrations, and runs as a non-root user.

docker pull ghcr.io/liteyukistudio/liteyukibot:v7.0.0a1
docker run --rm ghcr.io/liteyukistudio/liteyukibot:v7.0.0a1 version

Mount a liteyuki.toml at /app/liteyuki.toml and persistent volumes at /app/data, /app/cache, and /app/plugins for a configured deployment.

Development

uv run ruff check src tests scripts
uv run mypy
uv run pytest
uv build

The architecture contract is documented in docs/architecture/v7.md; the v6 compatibility boundary is documented in docs/migration-v6.md.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

liteyukibot_v7-7.0.0a1.tar.gz (36.0 kB view details)

Uploaded Aug 4, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

liteyukibot_v7-7.0.0a1-py3-none-any.whl (54.2 kB view details)

Uploaded Aug 4, 2026 Python 3

File details

Details for the file liteyukibot_v7-7.0.0a1.tar.gz.

File metadata

Download URL: liteyukibot_v7-7.0.0a1.tar.gz
Upload date: Aug 4, 2026
Size: 36.0 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","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}

File hashes

Hashes for liteyukibot_v7-7.0.0a1.tar.gz
Algorithm	Hash digest
SHA256	`f9fe8c4403ba24f200917b1f002290aaae09317cac0195117133e0664891318f`
MD5	`dce650ba13fcbd2c6dfb4f3bd26e4da4`
BLAKE2b-256	`4e0ca01813759f0cb17e5d36fff18bfff41598d872f3d242f8bd0dd5ed092b58`

See more details on using hashes here.

File details

Details for the file liteyukibot_v7-7.0.0a1-py3-none-any.whl.

File metadata

Download URL: liteyukibot_v7-7.0.0a1-py3-none-any.whl
Upload date: Aug 4, 2026
Size: 54.2 kB
Tags: Python 3
Uploaded using Trusted Publishing? Yes
Uploaded via: uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","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}

File hashes

Hashes for liteyukibot_v7-7.0.0a1-py3-none-any.whl
Algorithm	Hash digest
SHA256	`9fae6ae8d8aca0e6f12a833322987b90ebf5c51c2f4ae28d55c2b8fe41a923de`
MD5	`97f77c122a8347e0d6dfdec5d7c68387`
BLAKE2b-256	`729f7ea467f8393f391e99a65423b3b793a9c182f7fe316e72c1db53eeeeafcd`