Ontolith

A Python framework/SDK for building collaborative knowledge bases where humans and AI agents are co-equal authors of a shared, governed ontology.

Features

• Dual-principal model: Humans and AI agents as co-equal authors
• Provenance & confidence: Every assertion tracked with source and confidence
• Governed collaboration: Configurable proposal/review workflow
• Bitemporal time-travel: Query knowledge as of any point in time
• Conflict handling: Temporal supersession and explicit contradictions
• Plugin extensibility: Importers, exporters, reasoners, validators

Quick Start

# Clone repository
git clone https://github.com/ontolith/ontolith.git
cd ontolith

# Install dependencies (requires Python 3.11+)
uv sync

# Run tests
uv run pytest

# Run quality checks
uv run ruff check
uv run mypy --strict src conformance/conftest.py

# Run the quickstart example
uv run python examples/quickstart.py

Development Status

✅ v1.0.0 - M0–M4 complete; tagged 2026-09-28

Not yet published to PyPI — install from source (see Quick Start above). See docs/Ontolith_Implementation_Plan.md for the full milestone history and vNext plans.

Documentation

Full documentation site — a Getting
Started guide, conceptual overview, tutorials (governance & review,
bitemporal queries, writing a plugin, hybrid search), and the auto-generated
API reference. Built from site_docs/ via
mkdocs.yml; deployed by
.github/workflows/docs.yml on every push to
main.

Reference/planning documents:

• Product Requirements
• Technical Specification
• Use Cases & Interfaces
• Implementation Plan
• Architecture Decision Records
• Known Issues

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

License

Apache-2.0 - See LICENSE for details.