docs: add choose-your-module onboarding guide (#651)

* docs: add choose-your-module onboarding guide

* fix(docs): correct export code examples against actual API signatures

- export_to_rdf() returns a string; use export() for file output
- format="json-ld" is invalid; correct value is "jsonld"
- ParquetExporter/LPGExporter/ArangoAQLExporter take file_path as a
  required positional arg, not output= / output_dir= kwargs
- ArangoAQLExporter().export(graph) was missing file_path entirely,
  which would raise TypeError at runtime
- Remove misleading 'with provenance embedded' comment (no such param)

---------

Co-authored-by: KaifAhmad1 <kaifahmad087@gmail.com>
This commit is contained in:
Sameer Kadam
2026-06-19 13:15:06 +05:30
committed by GitHub
co-authored by KaifAhmad1
parent 12d61b92df
commit 926d4c1653
4 changed files with 338 additions and 18 deletions
+2 -15
View File
@@ -202,22 +202,9 @@ Semantica uses a modular, layered architecture: import only what you need.
- **[Output Layer](reference/export)** — Deliver results downstream. Modules: `export`, `visualization`, `pipeline`, `explorer`
## "Which module do I need?" Quick Reference
## Which Module Do I Need?
| I want to... | Module | Key class |
| :------------ | :------ | :--------- |
| Load a PDF / web page / database | `ingest` | `FileIngestor`, `WebIngestor` |
| Extract text and tables from a PDF | `parse` | `DocumentParser`, `DoclingParser` |
| Find entities in text | `semantic_extract` | `NERExtractor` |
| Build a knowledge graph | `kg` | `GraphBuilder` |
| Store and search vectors | `vector_store` | `VectorStore` |
| Give my agent persistent memory | `context` | `AgentContext` |
| Record AI decisions with audit trail | `context` | `AgentContext.record_decision()` |
| Query my graph with natural language | `reasoning` | `GraphReasoner` |
| Export to RDF / Neo4j / Parquet | `export` | `RDFExporter`, `LPGExporter` |
| Visualize a knowledge graph | `visualization` | `KGVisualizer` |
| Run a reproducible pipeline | `pipeline` | `PipelineBuilder` |
| Use Semantica from Claude Desktop | `mcp_server` | `semantica-mcp` |
See the [Choose the Right Module](choose-your-module) guide — it maps 35+ developer goals to the right starting point across all 27 modules, with working code for the most common paths.
## Next Steps