flare-kernel
通用编排与执行内核。
边界文档：
packages/flare-kernel/docs/KERNEL-BOUNDARY.mddocs/contracts/core/agent.mdpackages/flare-kernel/docs/replay-snapshot-technical-spec.md
职责：
- Decision 路由与策略入口。
- Execution 流程推进与状态管理。
- Runtime（含重试、超时、追踪）。
- 加载 domain pack 并执行。
Day 2 最小骨架
目录：
src/flare_kernel/router：接口路由src/flare_kernel/runtime：trace_id与基础日志src/flare_kernel/contracts：请求/响应契约
最小接口：
POST /kernel/runPOST /kernel/streamGET /kernel/healthPOST /kernel/knowledge/ingestPOST /kernel/knowledge/search
kernel 现已输出 mode/context 运行时占位事件与字段。
品牌注入（可选）
- kernel 支持从 domain-pack 读取品牌配置：
branding/instance-branding.json - 读取方式：
- 优先通过环境变量
FLARE_DOMAIN_PACK_ROOT显式指定 - 本地仓库运行时可回退到仓库根目录下的
domain-packs/
- 优先通过环境变量
- 注入位置：
POST /kernel/run响应result.instance_profilePOST /kernel/streamSSE 事件instance_profile
说明：品牌注入通过外部 domain-pack 配置，core 不写死产品名、logo、标签。
本地启动（示例）：
uvicorn flare_kernel.main:app --app-dir packages/flare-kernel/src --host 0.0.0.0 --port 8002
环境变量（真实链路）：
APIPRO_API_KEY（必填，真实 APIPro 调用）LLM_PROVIDER_BACKEND（当前本地模板为apipro）FLARE_POSTGRES_DSNFLARE_REDIS_URLFLARE_QDRANT_URL
健康检查会输出依赖状态：
llm_readypostgres_readyredis_readyqdrant_ready
模式决策优先级（/kernel/run 与 /kernel/stream）：
intent_override（外部业务侧注入）- 消息意图识别（内置关键词）
manual_modecurrent_mode- fallback（
intent/default）
安装与依赖
从 PyPI 安装：
pip install flare-kernel
启用可选的 RapidOCR 支持：
pip install "flare-kernel[ocr]"
本包要求 Python 3.11 或更高版本，并依赖 flare-engines >=1.0.0,<2.0.0。完整第三方依赖及可选依赖以 pyproject.toml 为准。
仓库内本地安装仍可使用 pip install packages/flare-kernel；发布元数据位于 packages/flare-kernel/pyproject.toml。
1 maintainer
Metadata
1 maintainer
Release files for flare-kernel 1.1.14
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| flare_kernel-1.1.14.tar.gz | 3.2 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| flare_kernel-1.1.14-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 5.7 MB
Release files / flare_kernel-1.1.14.tar.gz
| Download URL | flare_kernel-1.1.14.tar.gz |
|---|---|
| Size | 3.2 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4be230c2f0c2237815130a3d4f7cdf7caf7c655fdfa07a7866400a7dd94e126a
|
|
BLAKE2b-256 checksum How to use checksums |
284f9920285c8322ca413e9007b15c4a718a1a06e810e54972e9f4a11396524a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 9, 2026.
Transparency logRelease files / flare_kernel-1.1.14-py3-none-any.whl
| Download URL | flare_kernel-1.1.14-py3-none-any.whl |
|---|---|
| Size | 2.5 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7e5879a979a3c53531e1e120f19435ba5b39ed5e8069805601d5aaf29105b05c
|
|
BLAKE2b-256 checksum How to use checksums |
57f38d4dbb631c79bc4c7f7f5d20fd2c401f8fd19520bb432c19416bdf06ed0a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 9, 2026.
Transparency log
