mirror of
https://github.com/semantica-agi/semantica.git
synced 2026-09-13 04:04:09 +00:00
KaifAhmad1andClaude Sonnet 4.6
946a1089c8
- Migrate from mint.json to docs.json (Mintlify v4) - Theme: maple, emerald green + near-black dark / cream light palette (#059669 primary, #0A0A0A dark bg, #FAF7F0 light bg) - Typography: Lexend headings, Inter body - 5-tab navigation: Documentation, Quick Start, API Reference, Cookbook, FAQ - Homepage: removed badge stickers, redundant h2, added blockquote tagline, full 27-module reference table with semantica.mcp_server added - quickstart.md: CodeGroup per pipeline step, pattern vs LLM options, AccordionGroup for patterns and troubleshooting - faq.md: full AccordionGroup structure across 5 sections - reference/explorer.md: NEW — FastAPI explorer, Ontology Hub, Distance Intelligence, CLI reference, REST API endpoints - reference/mcp_server.md: NEW — MCP stdio server, 12 tools with I/O examples, 3 resources, Claude Desktop/VS Code/Windsurf/Cline config - docs.json: explorer added to Output group, mcp_server to Utilities group - Chat, feedback (thumbs/suggest/raise), OG/Twitter metadata, search topbar - All reference pages reformatted with Mintlify JSX components Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
159 lines
4.1 KiB
Markdown
159 lines
4.1 KiB
Markdown
---
|
|
title: "Seed Module"
|
|
description: "Seed data management for initializing Knowledge Graphs from trusted, verified sources."
|
|
icon: "database"
|
|
---
|
|
|
|
> Bootstrap Knowledge Graphs with verified taxonomies, reference data, and foundation graphs.
|
|
|
|
---
|
|
|
|
## Overview
|
|
|
|
The **Seed Module** provides a system for initializing Knowledge Graphs with verified, structured data from trusted sources — enabling you to start with a reliable foundation rather than an empty graph.
|
|
|
|
<CardGroup cols={3}>
|
|
<Card title="Multi-Source Loading" icon="database">
|
|
Load seed data from CSV, JSON, databases, and APIs.
|
|
</Card>
|
|
<Card title="Foundation Graph" icon="diagram-project">
|
|
Build a reliable KG foundation to bootstrap extraction.
|
|
</Card>
|
|
<Card title="Data Integration" icon="code-merge">
|
|
Merge seed data with extracted data using configurable strategies.
|
|
</Card>
|
|
<Card title="Validation" icon="circle-check">
|
|
Validate seed data quality and schema compliance.
|
|
</Card>
|
|
<Card title="Versioning" icon="code-branch">
|
|
Manage and track versions of seed data sources.
|
|
</Card>
|
|
<Card title="Export" icon="file-export">
|
|
Export seed data to standard formats.
|
|
</Card>
|
|
</CardGroup>
|
|
|
|
<Tip>
|
|
**When to use the Seed Module:**
|
|
- **Bootstrapping** — you have existing structured data (taxonomies, user lists, product catalogs) and want to build on them.
|
|
- **Reference data** — loading immutable reference information (countries, codes, constants).
|
|
- **Testing** — loading consistent datasets for development and CI.
|
|
</Tip>
|
|
|
|
---
|
|
|
|
## SeedDataManager
|
|
|
|
```python
|
|
from semantica.seed import SeedDataManager
|
|
|
|
manager = SeedDataManager()
|
|
manager.register_source("countries", "csv", "data/countries.csv")
|
|
foundation_kg = manager.create_foundation_graph()
|
|
```
|
|
|
|
| Method | Description |
|
|
|--------|-------------|
|
|
| `register_source(name, format, location)` | Add a data source |
|
|
| `create_foundation_graph()` | Build KG from registered sources |
|
|
| `validate_quality(seed_data)` | Check data quality |
|
|
| `integrate_with_extracted(seed, extracted)` | Merge seed and extracted graphs |
|
|
| `export_seed_data(path, format)` | Export seed data |
|
|
|
|
---
|
|
|
|
## SeedDataSource
|
|
|
|
```python
|
|
from semantica.seed import SeedDataSource
|
|
|
|
source = SeedDataSource(
|
|
name="taxonomy",
|
|
type="json", # "csv" | "json" | "api" | "sql"
|
|
path="taxonomy.json",
|
|
config={"encoding": "utf-8"}
|
|
)
|
|
```
|
|
|
|
---
|
|
|
|
## Merge Strategies
|
|
|
|
```python
|
|
final_kg = manager.integrate_seed_extracted(
|
|
seed_graph=foundation_kg,
|
|
extracted_data=new_data,
|
|
strategy="seed_first" # "seed_first" | "extracted_first" | "smart_merge"
|
|
)
|
|
```
|
|
|
|
| Strategy | Behavior |
|
|
|----------|----------|
|
|
| `seed_first` | Seed data overrides extracted data |
|
|
| `extracted_first` | Extracted data overrides seed data |
|
|
| `smart_merge` | Property-level merging with conflict resolution |
|
|
|
|
---
|
|
|
|
## Bootstrapping a KG
|
|
|
|
```python
|
|
from semantica.seed import SeedDataManager
|
|
from semantica.ingest import FileIngestor
|
|
|
|
# Load foundation from verified data
|
|
manager = SeedDataManager()
|
|
manager.register_source("taxonomy", "json", "taxonomy.json")
|
|
foundation_kg = manager.create_foundation_graph()
|
|
|
|
# Ingest and merge new data
|
|
ingestor = FileIngestor()
|
|
new_data = ingestor.ingest("news_articles.pdf")
|
|
|
|
final_kg = manager.integrate_seed_extracted(
|
|
seed_graph=foundation_kg,
|
|
extracted_data=new_data,
|
|
strategy="seed_first"
|
|
)
|
|
```
|
|
|
|
---
|
|
|
|
## Configuration
|
|
|
|
```yaml
|
|
seed:
|
|
sources:
|
|
- name: "employees"
|
|
type: "csv"
|
|
path: "./data/employees.csv"
|
|
merge:
|
|
strategy: "seed_first"
|
|
validation:
|
|
strict: true
|
|
```
|
|
|
|
```bash
|
|
export SEED_DATA_DIR=./data/seed
|
|
export SEED_MERGE_STRATEGY=seed_first
|
|
```
|
|
|
|
---
|
|
|
|
## See Also
|
|
|
|
<CardGroup cols={2}>
|
|
<Card title="Ingest" icon="file-import" href="ingest">
|
|
Load unstructured data alongside seed data.
|
|
</Card>
|
|
<Card title="Knowledge Graph" icon="diagram-project" href="kg">
|
|
The target graph structure.
|
|
</Card>
|
|
<Card title="Deduplication" icon="copy" href="deduplication">
|
|
Handle duplicates during merge.
|
|
</Card>
|
|
<Card title="Pipeline" icon="gear" href="pipeline">
|
|
Incorporate seed loading in a pipeline.
|
|
</Card>
|
|
</CardGroup>
|