Structured facts and relationships your assistant will not forget
Store and query entities, relations, and attributes. Power precise recall for planning and context-aware assistance.
What Knowledge Graph does
Knowledge Graph stores structured facts as triples (subject-predicate-object) and enables precise queries over entities and relationships. Perfect for remembering people, places, dates, dependencies, and other structured information that powers context-aware planning.
Core capabilities
- Register entities and relationships
- Query by entity, relation, or attribute
- Join with vector recall for hybrid search
- Delete or update facts
Use cases
- Remember people, roles, and preferences
- Track project dependencies and ownership
- Store system facts for change-impact analysis
Who benefits from Knowledge Graph
Individuals
Remember people, places, and dates with perfect accuracy
Teams & Managers
Track project facts, dependencies, and ownership
Developers & IT
SPARQL-like or JSON query schemas for structured data
Security & Compliance
On-prem graph with controlled ingest
How it works
Register facts as triples
Use kg.register_item to store (subject, predicate, object) triples. Example: (Alice, manages, Bob).
Query by entity or relationship
Call kg.query with filters (entity, relation, attribute) to retrieve matching facts.
Join with vector recall
Combine structured facts from KG with semantic search from vector memory for hybrid recall.
Update or delete facts
Use kg.delete to remove outdated facts or update relationships.
Example workflows
Remember people and preferences
Runs entirely offline"Remember: Alice is my boss, email alice@example.com, prefers mornings"
- kg.register_item (Alice, role, boss)
- kg.register_item (Alice, email, alice@example.com)
- kg.register_item (Alice, prefers, mornings)
Later: "Draft an email to my boss" → retrieves Alice's email and preferences
Track project dependencies
Runs entirely offline"Project X depends on Service Y, owned by Team Z"
- kg.register_item (Project X, depends_on, Service Y)
- kg.register_item (Service Y, owned_by, Team Z)
Query: "What depends on Service Y?" → returns Project X and impact analysis
System facts for change-impact analysis
Runs entirely offlineStore system architecture facts
- kg.register_item (API Gateway, calls, Auth Service)
- kg.register_item (Auth Service, uses, Database X)
- kg.query (what calls Auth Service?)
Impact report: "Changing Auth Service affects API Gateway"
Technical details
Configuration
STORAGE_BACKEND— local graph DB (default: SQLite)NAMESPACES— separate graphs for different contextsMAX_TRIPLES— capacity limit (default: 1M)
Performance notes
- Query: 10-50ms for 10K triples
- Register: 5-20ms per triple
- Scales to 1M+ triples on typical hardware
Observability
- Triple count and graph size
- Query latency and result counts
- Register/delete throughput
Security posture
Local graph database
All facts stored on-premises. No network calls for queries.
Optional ingest approvals
Require approval for registering sensitive facts (e.g., PII, credentials).
Audit logs
All register, query, and delete operations logged locally.
Namespaces for isolation
Separate graphs for different contexts. Prevents cross-contamination.
Roadmap & status
Current features
- Register, query, and delete triples
- Entity and relationship queries
- Namespaces for multi-tenant use
Coming soon
- Schema validation for triples
- Sync adapters for distributed graphs
- Graph visualization UI
Frequently asked questions
Ready to build structured knowledge?
Get started with Knowledge Graph in minutes. All facts stored locally.