IronHive.Flux.Core
0.17.1
dotnet add package IronHive.Flux.Core --version 0.17.1
NuGet\Install-Package IronHive.Flux.Core -Version 0.17.1
<PackageReference Include="IronHive.Flux.Core" Version="0.17.1" />
<PackageVersion Include="IronHive.Flux.Core" Version="0.17.1" />
<PackageReference Include="IronHive.Flux.Core" />
paket add IronHive.Flux.Core --version 0.17.1
#r "nuget: IronHive.Flux.Core, 0.17.1"
#:package IronHive.Flux.Core@0.17.1
#addin nuget:?package=IronHive.Flux.Core&version=0.17.1
#tool nuget:?package=IronHive.Flux.Core&version=0.17.1
IronHive.Flux
IronHive와 Flux 생태계(FileFlux, WebFlux, FluxIndex)를 연결하는 브릿지 SDK. Flux 통합 외에, ironhive 에이전트를 위한 외부 도구/파이프라인 통합(WebLookup, system-harness)도 이 레포가 소유한다 — 별도 통합 지점을 신설하지 않고 기존 브릿지 레이어에 얹는다.
패키지
| Package | Description |
|---|---|
IronHive.Flux.Core |
핵심 어댑터 (Embedding, TextCompletion, ImageToText) — IronHive 모델을 FileFlux · WebFlux · FluxCurator · FluxIndex 포트로 |
IronHive.Flux.Rag |
RAG 도구 (검색, 메모라이즈, 상태 조회) |
IronHive.Flux |
메타패키지 — IronHive.Flux.Core + IronHive.Flux.Rag 만 묶는다(WebLookup · Tools 패키지는 따로 설치) |
IronHive.Flux.WebLookup |
WebLookup → WebFlux → FluxIndex RAG 파이프라인 |
IronHive.Tools.WebLookup |
에이전트용 웹 검색/탐색 FunctionTool |
IronHive.Tools.SystemHarness |
system-harness MCP 서버 통합 확장 |
기능
| 기능 | 진입점 | 켜는 법 |
|---|---|---|
| IronHive 모델을 Flux 포트로 | AddIronHiveFluxCore(o => …)(모델 id 등 옵션만 등록) + 임베딩·텍스트 완성·이미지→텍스트 어댑터 |
opt-in. AddIronHiveFileFluxAdapters · AddIronHiveWebFluxAdapters · AddIronHiveFluxIndexAdapters(또는 AddAllIronHiveFluxAdapters)로 각 Flux 패키지의 포트에 연결 — 텍스트 완성은 공용 Flux.Abstractions.ITextCompletionService 하나(IronHiveTextCompletionService)를 모든 패키지가 함께 받는다 — 임베딩은 어댑터 없이 AddIronHiveEmbeddingGenerator()(각 Add…Adapters 가 부른다)가 IronHive 생성기를 컨테이너의 Microsoft.Extensions.AI 생성기로 한 번 등록하고(EmbeddingDimension 을 주면 그 크기를 메타데이터로 알린다), FileFlux · WebFlux 의 시맨틱 청킹과 FluxIndex 가 그것을 받는다. 어댑터는 IronHive IEmbeddingGenerator · IMessageGenerator 를 컨테이너에서 받으므로 그 둘을 먼저 등록한다(예: services.AddSingleton(hive.GetEmbeddingGenerator("openai"))) |
| 에이전트용 RAG 도구 | AddFluxRagTools(o => …) → provider.GetFluxRagTools() — search_knowledge_base · memorize_document(s) · memorize_directory · memorize_web_page · forget_document · list_documents · get_document_info · detect_changes · knowledge_base_status |
opt-in. FluxFeed IVault 가 먼저 등록돼 있어야 한다. memorize_web_page 는 WebFlux 로 추출하므로(robots.txt · 요청 타임아웃 · 보일러플레이트 제거) services.AddWebFlux() 가 등록돼 있을 때만 포함된다 |
| 적재 경로 보안 | ConfigureVaultSecurity(o => …) — AllowedBasePaths(비면 제한 없음) · MaxFileSizeBytes(기본 100 MB) · RejectSymlinks(기본 true) |
기본값으로 켜져 있다. AddFluxRagTools 앞이든 뒤든 호출하면 memorize 도구가 그 값을 쓴다 |
| RAG 컨텍스트 조립 | AddFluxRagContext(…) → RagContextBuilder.BuildContextAsync |
opt-in |
| 웹 검색 → RAG 적재 | AddWebLookupRagPipeline(…) → WebLookupRagPipeline(DiscoverUrlsAsync · DiscoverSitemapUrlsAsync · DiscoverCombinedUrlsAsync) |
opt-in. WebLookup(services.AddWebLookup(…))이 먼저 |
| 에이전트용 웹 도구 | services.AddWebLookupTools(…) + tools.AddWebLookupTools(provider) — web_search · explore_site |
opt-in. WebLookup 이 먼저 |
| 컴퓨터 제어(MCP) | McpClientManager.AddSystemHarness(…) — system-harness MCP 서버의 help/do/get 3 도구 |
opt-in. 연결되면 매니저의 IToolCollection 에 도구가 채워진다 |
시나리오
RAG Chatbot
IronHive + FluxIndex (FluxFeed IVault)
→ 지식기반 챗봇 서비스
예제: samples/RagChatbotSample — RAG 도구 목록과 RagContextBuilder 컨텍스트 조립.
Quick Start
// Core 설정 (옵션)
services.AddIronHiveFluxCore(options =>
{
options.EmbeddingModelId = "text-embedding-3-small";
options.TextCompletionModelId = "gpt-4o";
});
// Flux 포트 어댑터 (IronHive IEmbeddingGenerator / IMessageGenerator 가 등록돼 있어야 한다)
services.AddAllIronHiveFluxAdapters();
// RAG 도구
services.AddFluxRagTools(options =>
{
options.DefaultMaxResults = 5;
options.DefaultSearchStrategy = "hybrid";
});
Build
dotnet build IronHive.Flux.slnx
dotnet test
Docs
License
MIT
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- FileFlux (>= 0.65.0)
- FluxCurator (>= 0.17.0)
- FluxIndex.Core (>= 0.100.0)
- IronHive.Abstractions (>= 0.66.1)
- IronHive.Extensions.AI (>= 0.66.1)
- Microsoft.Bcl.Memory (>= 10.0.8)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Options (>= 10.0.13)
- TokenMeter (>= 0.13.1)
- WebFlux (>= 0.26.1)
NuGet packages (3)
Showing the top 3 NuGet packages that depend on IronHive.Flux.Core:
| Package | Downloads |
|---|---|
|
IronHive.Flux.Rag
RAG tools for IronHive using FluxIndex capabilities |
|
|
IronHive.Flux
Complete bridge SDK connecting IronHive AI framework with Flux ecosystem (FileFlux, WebFlux, FluxIndex). Includes Core adapters and RAG capabilities. |
|
|
IronHive.Flux.WebLookup
WebLookup → WebFlux → FluxIndex RAG pipeline for discovering, processing, and indexing web content |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated | |
|---|---|---|---|
| 0.17.1 | 372 | 10/16/2026 | |
| 0.17.0 | 142 | 10/15/2026 | |
| 0.16.0 | 155 | 10/11/2026 | |
| 0.15.0 | 147 | 10/10/2026 | |
| 0.14.0 | 148 | 10/9/2026 | |
| 0.13.1 | 139 | 10/9/2026 | |
| 0.13.0 | 146 | 10/8/2026 | |
| 0.12.26 | 142 | 10/8/2026 | |
| 0.12.25 | 141 | 10/7/2026 | |
| 0.12.24 | 141 | 10/7/2026 | |
| 0.12.23 | 143 | 10/7/2026 | |
| 0.12.22 | 143 | 10/7/2026 | |
| 0.12.21 | 149 | 10/7/2026 | |
| 0.12.20 | 143 | 10/7/2026 | |
| 0.12.19 | 153 | 10/7/2026 | |
| 0.12.18 | 138 | 10/7/2026 | |
| 0.12.17 | 147 | 10/6/2026 | |
| 0.12.16 | 150 | 10/6/2026 | |
| 0.12.15 | 140 | 10/6/2026 | |
| 0.12.14 | 143 | 10/6/2026 |