flare-kernel

通用编排与执行内核。

边界文档：

  1. packages/flare-kernel/docs/KERNEL-BOUNDARY.md
  2. docs/contracts/core/agent.md
  3. packages/flare-kernel/docs/replay-snapshot-technical-spec.md

职责：

  1. Decision 路由与策略入口。
  2. Execution 流程推进与状态管理。
  3. Runtime（含重试、超时、追踪）。
  4. 加载 domain pack 并执行。

Day 2 最小骨架

目录：

  1. src/flare_kernel/router：接口路由
  2. src/flare_kernel/runtime：trace_id 与基础日志
  3. src/flare_kernel/contracts：请求/响应契约

最小接口：

  1. POST /kernel/run
  2. POST /kernel/stream
  3. GET /kernel/health
  4. POST /kernel/knowledge/ingest
  5. POST /kernel/knowledge/search

kernel 现已输出 mode/context 运行时占位事件与字段。

品牌注入（可选）

  1. kernel 支持从 domain-pack 读取品牌配置： branding/instance-branding.json
  2. 读取方式：
    • 优先通过环境变量 FLARE_DOMAIN_PACK_ROOT 显式指定
    • 本地仓库运行时可回退到仓库根目录下的 domain-packs/
  3. 注入位置：
    • POST /kernel/run 响应 result.instance_profile
    • POST /kernel/stream SSE 事件 instance_profile

说明：品牌注入通过外部 domain-pack 配置，core 不写死产品名、logo、标签。

本地启动（示例）：

uvicorn flare_kernel.main:app --app-dir packages/flare-kernel/src --host 0.0.0.0 --port 8002

环境变量（真实链路）：

  1. APIPRO_API_KEY（必填，真实 APIPro 调用）
  2. LLM_PROVIDER_BACKEND（当前本地模板为 apipro）
  3. FLARE_POSTGRES_DSN
  4. FLARE_REDIS_URL
  5. FLARE_QDRANT_URL

健康检查会输出依赖状态：

  1. llm_ready
  2. postgres_ready
  3. redis_ready
  4. qdrant_ready

模式决策优先级（/kernel/run 与 /kernel/stream）：

  1. intent_override（外部业务侧注入）
  2. 消息意图识别（内置关键词）
  3. manual_mode
  4. current_mode
  5. 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。

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.1.18)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for dva89 from gravatar.com dva89

License expression

LicenseRef-Proprietary
View SPDX License List

Requires

Python >=3.11

Provides Extra

ocr

Classifiers

Report project as malware

Metadata

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.1.18)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for dva89 from gravatar.com dva89

License expression

LicenseRef-Proprietary
View SPDX License List

Requires

Python >=3.11

Provides Extra

ocr

Classifiers

Report project as malware

Release files for flare-kernel 1.1.11

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

Source distribution (sdist)

Source distribution for flare-kernel 1.1.11
File Size Uploaded
flare_kernel-1.1.11.tar.gz 3.1 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for flare-kernel 1.1.11
File Interpreter ABI Platform
flare_kernel-1.1.11-py3-none-any.whl 2.5 MB Python 3 none any Details

Total release size: 5.6 MB

Release files / flare_kernel-1.1.11.tar.gz

Download URL flare_kernel-1.1.11.tar.gz
Size 3.1 MB
Tags Source
SHA-256 checksum
How to use checksums 		c23246242ce9925141906377f6718c65d8bcdafd952cd3257723371442499ca6
BLAKE2b-256 checksum
How to use checksums 		16297a08fcee08f7a4824dae863e2ae69f2d5de4ba6e56a1cf20fba6940425be
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing? 		No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / flare_kernel-1.1.11-py3-none-any.whl

Download URL flare_kernel-1.1.11-py3-none-any.whl
Size 2.5 MB
Tags Python 3
SHA-256 checksum
How to use checksums 		0210a35fad3886eba8f5e56435f1fe25c9a157badfd80b981924fe44adb96ceb
BLAKE2b-256 checksum
How to use checksums 		790d2a995b81c15f05b4f1428c8b3b25c9454a27632b2f4b3ad1621b82598a8f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing? 		No
Uploaded via twine/7.0.0 CPython/3.13.14

Release history Release notifications | RSS feed

1.1.18

2 release files

1.1.17

2 release files

1.1.16

2 release files

1.1.15

2 release files

1.1.14

2 release files

1.1.13

2 release files

1.1.12

2 release files

This release

1.1.11 This release

2 release files

1.1.10

2 release files

1.1.9

2 release files

1.1.8

2 release files

1.1.7

2 release files

1.1.6

2 release files

1.1.5

2 release files

1.1.4

2 release files

1.1.3

2 release files

1.1.2

2 release files

1.1.1

2 release files

1.1.0

2 release files

1.0.9

2 release files

1.0.8

2 release files

1.0.7

2 release files

1.0.6

2 release files

1.0.5

2 release files

1.0.4

2 release files

1.0.3

2 release files

1.0.2

2 release files

1.0.1

2 release files

1.0.0

2 release files

0.2.15

2 release files

0.2.14

2 release files

0.2.13

2 release files

0.2.12

2 release files

0.2.11

2 release files

0.2.10

2 release files

0.2.9

2 release files

0.2.8

2 release files

0.2.7

2 release files

0.2.6

2 release files

0.2.5

2 release files

0.2.4

2 release files

0.2.3

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.0

2 release files

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