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)
最小发布说明
- 当前包版本:
0.1.0 - 发布元数据:
packages/flare-kernel/pyproject.toml - 本地构建:
python -m build - 本地安装:
pip install packages/flare-kernel
Metadata
Release files for flare-kernel 1.1.10
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.10.tar.gz | 2.9 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| flare_kernel-1.1.10-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 5.3 MB
Release files / flare_kernel-1.1.10.tar.gz
| Download URL | flare_kernel-1.1.10.tar.gz |
|---|---|
| Size | 2.9 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
686dd89d6592cf307618051e7a200411b99f32dd62b62f07edc71cebd79b8452
|
|
BLAKE2b-256 checksum How to use checksums |
42c5d275fec4064293043abc855cc9d35a730c8e947377530e0f513ed872af3a
|
| 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.10-py3-none-any.whl
| Download URL | flare_kernel-1.1.10-py3-none-any.whl |
|---|---|
| Size | 2.4 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
704eae3631028276f10b749e06adf95b3d69e780d6024eb4dacc5636cddf12c9
|
|
BLAKE2b-256 checksum How to use checksums |
25d55b6316dce8437da419afceffb5794e0fb970047d2692e9801d2b4b164d96
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|