reasongraph 0.2.0__tar.gz

reasongraph-0.2.0/.github/workflows/publish.yml

@@ -0,0 +1,28 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

reasongraph-0.2.0/.github/workflows/test.yml

@@ -0,0 +1,29 @@
+name: Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Run tests
+        run: uv run pytest -v

reasongraph-0.2.0/.gitignore

@@ -0,0 +1,39 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.egg
+*.egg-info/
+.eggs/
+
+# Distribution
+dist/
+build/
+*.whl
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Locks
+uv.lock
+
+# Local scratch
+tmp/

reasongraph-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Berk
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

reasongraph-0.2.0/PKG-INFO

@@ -0,0 +1,230 @@
+Metadata-Version: 2.4
+Name: reasongraph
+Version: 0.2.0
+Summary: A graph-based reasoning library with embedding search and multi-hop traversal
+Project-URL: Homepage, https://github.com/bgokden/reasongraph
+Project-URL: Repository, https://github.com/bgokden/reasongraph
+Project-URL: Issues, https://github.com/bgokden/reasongraph/issues
+Author: Berk
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agent,causal-reasoning,embeddings,knowledge-graph,multi-hop,ner,nlp,rag,reasoning,semantic-search
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: aiosqlite>=0.19.0
+Requires-Dist: sentence-transformers>=2.2.0
+Requires-Dist: sqlite-vec>=0.1.6
+Provides-Extra: all
+Requires-Dist: gliner2>=1.2.0; extra == 'all'
+Requires-Dist: pgvector>=0.2.0; extra == 'all'
+Requires-Dist: psycopg-pool>=3.1.0; extra == 'all'
+Requires-Dist: psycopg[binary]>=3.1.0; extra == 'all'
+Requires-Dist: requests>=2.28.0; extra == 'all'
+Requires-Dist: urllib3>=2.0.0; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Provides-Extra: gliner2
+Requires-Dist: gliner2>=1.2.0; extra == 'gliner2'
+Requires-Dist: requests>=2.28.0; extra == 'gliner2'
+Requires-Dist: urllib3>=2.0.0; extra == 'gliner2'
+Provides-Extra: postgres
+Requires-Dist: pgvector>=0.2.0; extra == 'postgres'
+Requires-Dist: psycopg-pool>=3.1.0; extra == 'postgres'
+Requires-Dist: psycopg[binary]>=3.1.0; extra == 'postgres'
+Description-Content-Type: text/markdown
+
+# reasongraph
+
+A graph-based reasoning library with embedding search, multi-hop traversal, and automatic entity/causal extraction.
+
+[![PyPI version](https://img.shields.io/pypi/v/reasongraph)](https://pypi.org/project/reasongraph/)
+[![Python 3.11+](https://img.shields.io/pypi/pyversions/reasongraph)](https://pypi.org/project/reasongraph/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+## Installation
+
+```bash
+pip install reasongraph[all]        # everything included
+```
+
+Or install only what you need:
+
+```bash
+pip install reasongraph             # core: SQLite backend, NER extraction, embeddings
+pip install reasongraph[gliner2]    # + GLiNER2 entity + causal extraction (recommended)
+pip install reasongraph[postgres]   # + PostgreSQL + pgvector backend
+```
+
+## Quick Start
+
+```python
+from reasongraph import ReasonGraph
+
+graph = ReasonGraph()
+graph.initialize_sync()
+
+# Add text with automatic entity + causal extraction
+graph.add_text_sync("Lehman Brothers filed for bankruptcy in September 2008.")
+graph.add_text_sync("The Federal Reserve cut interest rates to near zero.")
+
+# Query with embedding search + multi-hop graph traversal
+results = graph.query_sync("What caused the 2008 financial crisis?")
+for text in results:
+    print(text)
+
+graph.close_sync()
+```
+
+Or use the async API with a context manager:
+
+```python
+import asyncio
+from reasongraph import ReasonGraph
+
+async def main():
+    async with ReasonGraph() as graph:
+        await graph.load_dataset("financial")
+        results = await graph.query("What caused the 2008 crisis?")
+        for text in results:
+            print(text)
+
+asyncio.run(main())
+```
+
+## Features
+
+- **Automatic extraction** -- GLiNER2 extracts entities and causal relations in one pass (falls back to BERT NER when gliner2 is not installed)
+- **Hybrid search** -- combine embedding similarity, keyword (trigram) matching, or both
+- **Multi-hop traversal** -- follow graph edges to discover connected reasoning chains
+- **Cross-encoder reranking** -- rerank results at each hop with `ms-marco-MiniLM-L-6-v2`
+- **Built-in datasets** -- load curated reasoning graphs for immediate use
+- **Async-first** -- native async API with sync convenience wrappers
+- **Pluggable backends** -- SQLite (zero-config default) or PostgreSQL with pgvector
+
+## Built-in Datasets
+
+| Dataset | Description |
+|---------|-------------|
+| `syllogisms` | Classical syllogistic reasoning chains |
+| `causal` | Cause-effect reasoning with entity annotations |
+| `taxonomy` | Hierarchical concept taxonomy |
+| `financial` | Financial crisis causal chains (2008 crisis, dot-com, inflation, eurozone) |
+| `medical` | Medical causal chains (heart disease, diabetes, infectious disease, cancer) |
+| `analysis_patterns` | Data analysis reasoning: scenario detection, technique selection, implementation patterns |
+
+```python
+graph.load_dataset_sync("financial")
+```
+
+## Search Modes
+
+```python
+# Pure embedding similarity (default)
+results = graph.query_sync("credit freeze", search_mode="embedding")
+
+# Pure keyword/trigram matching
+results = graph.query_sync("credit freeze", search_mode="keyword")
+
+# Hybrid: Reciprocal Rank Fusion of embedding + trigram rankings
+results = graph.query_sync("credit freeze", search_mode="hybrid")
+
+# Tune the RRF smoothing constant (default 60, lower = more weight to top ranks)
+results = graph.query_sync("credit freeze", search_mode="hybrid", rrf_k=30)
+```
+
+## Entity and Causal Extraction
+
+When `gliner2` is installed, `add_text()` / `add_texts()` automatically use GLiNER2 for both entity extraction and causal relation detection. Without `gliner2`, it falls back to BERT NER (entities only).
+
+```python
+from reasongraph import ReasonGraph, NERExtractor, GLiNER2Extractor
+
+graph = ReasonGraph()
+graph.initialize_sync()
+
+# Default: GLiNER2 (entities + causal relations) if installed, else BERT NER
+entities = graph.add_text_sync("Apple released the iPhone in 2007.")
+print(entities)  # ['Apple', 'iPhone']
+
+# Explicit: force BERT NER even if GLiNER2 is installed
+entities = graph.add_text_sync("Apple released the iPhone in 2007.", extractor=NERExtractor())
+
+# Explicit: GLiNER2 with custom entity types
+gliner = GLiNER2Extractor(entity_types=["company", "product", "date"])
+entities = graph.add_text_sync("Apple released the iPhone in 2007.", extractor=gliner)
+
+# Any callable works
+entities = graph.add_text_sync("some text", extractor=lambda t: ["custom"])
+```
+
+## PostgreSQL Backend
+
+```python
+from reasongraph import ReasonGraph
+from reasongraph.backends import PostgresBackend
+
+graph = ReasonGraph(backend=PostgresBackend(database_url="postgresql://user:pass@localhost/db"))
+```
+
+Requires `pip install reasongraph[postgres]` and the `pgvector` + `pg_trgm` extensions enabled on your database.
+
+## Evaluation: Mixed-Domain Reasoning
+
+We evaluate reasoning quality by loading all 6 built-in datasets into a single graph (~130 text nodes, ~104 entity nodes, ~280 edges) and testing whether the library can trace the correct causal chains, syllogistic proofs, taxonomic hierarchies, and data analysis patterns -- without being distracted by unrelated facts from other domains.
+
+32 test cases simulate agent-style queries like *"I need to understand what caused the 2008 financial crisis"*, *"How does insulin resistance lead to kidney failure?"*, or *"I have two numeric columns, check if related"* and check whether the returned reasoning chain matches the expected ground truth.
+
+**Per-domain results (hybrid search, `top_k=5`, `hops=4`, `rerank_top_k=4`):**
+
+| Domain | Cases | Chain Completeness | Recall@5 | Precision@5 | Domain Accuracy |
+|--------|------:|--------------------|----------|-------------|-----------------|
+| Causal | 5 | 100% | 100% | 92% | 100% |
+| Financial | 6 | 100% | 82% | 60% | 100% |
+| Medical | 5 | 100% | 92% | 76% | 92% |
+| Syllogisms | 5 | 100% | 100% | 92% | 85% |
+| Taxonomy | 3 | 100% | 83% | 53% | 92% |
+| Analysis Patterns | 8 | 96% | 75% | 45% | 96% |
+| **Overall** | **32** | **99%** | **88%** | **68%** | **95%** |
+
+32/32 cases pass (>= 50% chain completeness). Split reranking gives chain continuations (text-to-text edges) priority over bridge discoveries (entity-to-text edges), keeping traversal focused.
+
+**Search mode comparison:**
+
+| Mode | Chain Completeness | Recall@5 | Precision@5 | Domain Accuracy |
+|------|-------------------|----------|-------------|-----------------|
+| Embedding | 99% | 88% | 68% | 95% |
+| Keyword | 0% | 0% | 0% | 0% |
+| Hybrid | 99% | 88% | 68% | 95% |
+
+Keyword-only mode scores 0% because the eval queries are natural language questions that don't substring-match the dataset's declarative statements. This is expected -- keyword search is designed for known-term lookups, not question answering.
+
+Reproduce: `uv run python tests/eval_financial_reasoning.py`
+
+## API Reference
+
+### `ReasonGraph(backend=None, embed_model=None, rerank_model=None, forget_after=30)`
+
+| Method | Description |
+|--------|-------------|
+| `add_nodes(nodes)` | Add `(content, type)` tuples to the graph |
+| `add_edges(edges)` | Add `(from, to)` content edges |
+| `add_text(text, extractor=None)` | Add text with automatic entity extraction |
+| `add_texts(texts, extractor=None, causal_extractor=None)` | Batch add with entity + causal extraction (auto-enabled with GLiNER2) |
+| `query(query, top_k=5, hops=4, rerank_top_k=4, search_mode="embedding", rrf_k=60)` | Search and traverse the graph |
+| `load_dataset(name)` | Load a built-in dataset |
+| `delete_stale()` | Remove nodes not accessed within `forget_after` days |
+| `get_all_nodes()` / `get_all_edges()` | Inspect graph contents |
+
+All methods are async. Sync variants are available with a `_sync` suffix (e.g. `query_sync`).
+
+## License
+
+MIT

reasongraph-0.2.0/README.md

@@ -0,0 +1,187 @@
+# reasongraph
+
+A graph-based reasoning library with embedding search, multi-hop traversal, and automatic entity/causal extraction.
+
+[![PyPI version](https://img.shields.io/pypi/v/reasongraph)](https://pypi.org/project/reasongraph/)
+[![Python 3.11+](https://img.shields.io/pypi/pyversions/reasongraph)](https://pypi.org/project/reasongraph/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+## Installation
+
+```bash
+pip install reasongraph[all]        # everything included
+```
+
+Or install only what you need:
+
+```bash
+pip install reasongraph             # core: SQLite backend, NER extraction, embeddings
+pip install reasongraph[gliner2]    # + GLiNER2 entity + causal extraction (recommended)
+pip install reasongraph[postgres]   # + PostgreSQL + pgvector backend
+```
+
+## Quick Start
+
+```python
+from reasongraph import ReasonGraph
+
+graph = ReasonGraph()
+graph.initialize_sync()
+
+# Add text with automatic entity + causal extraction
+graph.add_text_sync("Lehman Brothers filed for bankruptcy in September 2008.")
+graph.add_text_sync("The Federal Reserve cut interest rates to near zero.")
+
+# Query with embedding search + multi-hop graph traversal
+results = graph.query_sync("What caused the 2008 financial crisis?")
+for text in results:
+    print(text)
+
+graph.close_sync()
+```
+
+Or use the async API with a context manager:
+
+```python
+import asyncio
+from reasongraph import ReasonGraph
+
+async def main():
+    async with ReasonGraph() as graph:
+        await graph.load_dataset("financial")
+        results = await graph.query("What caused the 2008 crisis?")
+        for text in results:
+            print(text)
+
+asyncio.run(main())
+```
+
+## Features
+
+- **Automatic extraction** -- GLiNER2 extracts entities and causal relations in one pass (falls back to BERT NER when gliner2 is not installed)
+- **Hybrid search** -- combine embedding similarity, keyword (trigram) matching, or both
+- **Multi-hop traversal** -- follow graph edges to discover connected reasoning chains
+- **Cross-encoder reranking** -- rerank results at each hop with `ms-marco-MiniLM-L-6-v2`
+- **Built-in datasets** -- load curated reasoning graphs for immediate use
+- **Async-first** -- native async API with sync convenience wrappers
+- **Pluggable backends** -- SQLite (zero-config default) or PostgreSQL with pgvector
+
+## Built-in Datasets
+
+| Dataset | Description |
+|---------|-------------|
+| `syllogisms` | Classical syllogistic reasoning chains |
+| `causal` | Cause-effect reasoning with entity annotations |
+| `taxonomy` | Hierarchical concept taxonomy |
+| `financial` | Financial crisis causal chains (2008 crisis, dot-com, inflation, eurozone) |
+| `medical` | Medical causal chains (heart disease, diabetes, infectious disease, cancer) |
+| `analysis_patterns` | Data analysis reasoning: scenario detection, technique selection, implementation patterns |
+
+```python
+graph.load_dataset_sync("financial")
+```
+
+## Search Modes
+
+```python
+# Pure embedding similarity (default)
+results = graph.query_sync("credit freeze", search_mode="embedding")
+
+# Pure keyword/trigram matching
+results = graph.query_sync("credit freeze", search_mode="keyword")
+
+# Hybrid: Reciprocal Rank Fusion of embedding + trigram rankings
+results = graph.query_sync("credit freeze", search_mode="hybrid")
+
+# Tune the RRF smoothing constant (default 60, lower = more weight to top ranks)
+results = graph.query_sync("credit freeze", search_mode="hybrid", rrf_k=30)
+```
+
+## Entity and Causal Extraction
+
+When `gliner2` is installed, `add_text()` / `add_texts()` automatically use GLiNER2 for both entity extraction and causal relation detection. Without `gliner2`, it falls back to BERT NER (entities only).
+
+```python
+from reasongraph import ReasonGraph, NERExtractor, GLiNER2Extractor
+
+graph = ReasonGraph()
+graph.initialize_sync()
+
+# Default: GLiNER2 (entities + causal relations) if installed, else BERT NER
+entities = graph.add_text_sync("Apple released the iPhone in 2007.")
+print(entities)  # ['Apple', 'iPhone']
+
+# Explicit: force BERT NER even if GLiNER2 is installed
+entities = graph.add_text_sync("Apple released the iPhone in 2007.", extractor=NERExtractor())
+
+# Explicit: GLiNER2 with custom entity types
+gliner = GLiNER2Extractor(entity_types=["company", "product", "date"])
+entities = graph.add_text_sync("Apple released the iPhone in 2007.", extractor=gliner)
+
+# Any callable works
+entities = graph.add_text_sync("some text", extractor=lambda t: ["custom"])
+```
+
+## PostgreSQL Backend
+
+```python
+from reasongraph import ReasonGraph
+from reasongraph.backends import PostgresBackend
+
+graph = ReasonGraph(backend=PostgresBackend(database_url="postgresql://user:pass@localhost/db"))
+```
+
+Requires `pip install reasongraph[postgres]` and the `pgvector` + `pg_trgm` extensions enabled on your database.
+
+## Evaluation: Mixed-Domain Reasoning
+
+We evaluate reasoning quality by loading all 6 built-in datasets into a single graph (~130 text nodes, ~104 entity nodes, ~280 edges) and testing whether the library can trace the correct causal chains, syllogistic proofs, taxonomic hierarchies, and data analysis patterns -- without being distracted by unrelated facts from other domains.
+
+32 test cases simulate agent-style queries like *"I need to understand what caused the 2008 financial crisis"*, *"How does insulin resistance lead to kidney failure?"*, or *"I have two numeric columns, check if related"* and check whether the returned reasoning chain matches the expected ground truth.
+
+**Per-domain results (hybrid search, `top_k=5`, `hops=4`, `rerank_top_k=4`):**
+
+| Domain | Cases | Chain Completeness | Recall@5 | Precision@5 | Domain Accuracy |
+|--------|------:|--------------------|----------|-------------|-----------------|
+| Causal | 5 | 100% | 100% | 92% | 100% |
+| Financial | 6 | 100% | 82% | 60% | 100% |
+| Medical | 5 | 100% | 92% | 76% | 92% |
+| Syllogisms | 5 | 100% | 100% | 92% | 85% |
+| Taxonomy | 3 | 100% | 83% | 53% | 92% |
+| Analysis Patterns | 8 | 96% | 75% | 45% | 96% |
+| **Overall** | **32** | **99%** | **88%** | **68%** | **95%** |
+
+32/32 cases pass (>= 50% chain completeness). Split reranking gives chain continuations (text-to-text edges) priority over bridge discoveries (entity-to-text edges), keeping traversal focused.
+
+**Search mode comparison:**
+
+| Mode | Chain Completeness | Recall@5 | Precision@5 | Domain Accuracy |
+|------|-------------------|----------|-------------|-----------------|
+| Embedding | 99% | 88% | 68% | 95% |
+| Keyword | 0% | 0% | 0% | 0% |
+| Hybrid | 99% | 88% | 68% | 95% |
+
+Keyword-only mode scores 0% because the eval queries are natural language questions that don't substring-match the dataset's declarative statements. This is expected -- keyword search is designed for known-term lookups, not question answering.
+
+Reproduce: `uv run python tests/eval_financial_reasoning.py`
+
+## API Reference
+
+### `ReasonGraph(backend=None, embed_model=None, rerank_model=None, forget_after=30)`
+
+| Method | Description |
+|--------|-------------|
+| `add_nodes(nodes)` | Add `(content, type)` tuples to the graph |
+| `add_edges(edges)` | Add `(from, to)` content edges |
+| `add_text(text, extractor=None)` | Add text with automatic entity extraction |
+| `add_texts(texts, extractor=None, causal_extractor=None)` | Batch add with entity + causal extraction (auto-enabled with GLiNER2) |
+| `query(query, top_k=5, hops=4, rerank_top_k=4, search_mode="embedding", rrf_k=60)` | Search and traverse the graph |
+| `load_dataset(name)` | Load a built-in dataset |
+| `delete_stale()` | Remove nodes not accessed within `forget_after` days |
+| `get_all_nodes()` / `get_all_edges()` | Inspect graph contents |
+
+All methods are async. Sync variants are available with a `_sync` suffix (e.g. `query_sync`).
+
+## License
+
+MIT

reasongraph-0.2.0/examples/financial_demo.py

@@ -0,0 +1,75 @@
+"""Financial crisis analysis with reasongraph.
+
+This demo loads the built-in financial dataset and runs queries that
+an analyst or agent might ask when researching economic crises.
+"""
+
+import textwrap
+from reasongraph import ReasonGraph
+
+
+def print_results(question: str, results: list[str]) -> None:
+    print(f"\n{'=' * 70}")
+    print(f"Q: {question}")
+    print(f"{'=' * 70}")
+    for i, text in enumerate(results, 1):
+        wrapped = textwrap.fill(text, width=66, initial_indent="  ", subsequent_indent="  ")
+        print(f"  [{i}] {text}")
+    print()
+
+
+def main():
+    graph = ReasonGraph()
+    graph.initialize_sync()
+    graph.load_dataset_sync("financial")
+
+    # An analyst starts by asking about the 2008 crisis.
+    results = graph.query_sync(
+        "What caused the 2008 financial crisis?",
+        search_mode="hybrid",
+        top_k=5,
+        hops=2,
+    )
+    print_results("What caused the 2008 financial crisis?", results)
+
+    # They want to understand how inflation spiraled in 2021-2022.
+    results = graph.query_sync(
+        "How did inflation surge after the pandemic?",
+        search_mode="hybrid",
+        top_k=5,
+        hops=2,
+    )
+    print_results("How did inflation surge after the pandemic?", results)
+
+    # Next: how does the Fed respond to crises?
+    results = graph.query_sync(
+        "What did the Federal Reserve do about interest rates?",
+        search_mode="hybrid",
+        top_k=5,
+        hops=2,
+    )
+    print_results("What did the Federal Reserve do about interest rates?", results)
+
+    # The dot-com bubble -- is there a pattern?
+    results = graph.query_sync(
+        "What happened during the dot-com bubble?",
+        search_mode="hybrid",
+        top_k=5,
+        hops=2,
+    )
+    print_results("What happened during the dot-com bubble?", results)
+
+    # European sovereign debt -- contagion across borders.
+    results = graph.query_sync(
+        "How did the Greek debt crisis spread to other countries?",
+        search_mode="hybrid",
+        top_k=3,
+        hops=3,
+    )
+    print_results("How did the Greek debt crisis spread to other countries?", results)
+
+    graph.close_sync()
+
+
+if __name__ == "__main__":
+    main()

reasongraph-0.2.0/pyproject.toml

@@ -0,0 +1,73 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "reasongraph"
+version = "0.2.0"
+description = "A graph-based reasoning library with embedding search and multi-hop traversal"
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+authors = [
+    {name = "Berk"},
+]
+keywords = [
+    "knowledge-graph", "reasoning", "rag", "embeddings", "nlp",
+    "semantic-search", "causal-reasoning", "multi-hop", "ner", "agent",
+]
+classifiers = [
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Typing :: Typed",
+]
+dependencies = [
+    "sentence-transformers>=2.2.0",
+    "aiosqlite>=0.19.0",
+    "sqlite-vec>=0.1.6",
+]
+
+[project.urls]
+Homepage = "https://github.com/bgokden/reasongraph"
+Repository = "https://github.com/bgokden/reasongraph"
+Issues = "https://github.com/bgokden/reasongraph/issues"
+
+[project.optional-dependencies]
+gliner2 = [
+    "gliner2>=1.2.0",
+    "urllib3>=2.0.0",
+    "requests>=2.28.0",
+]
+postgres = [
+    "psycopg[binary]>=3.1.0",
+    "psycopg-pool>=3.1.0",
+    "pgvector>=0.2.0",
+]
+all = [
+    "gliner2>=1.2.0",
+    "urllib3>=2.0.0",
+    "requests>=2.28.0",
+    "psycopg[binary]>=3.1.0",
+    "psycopg-pool>=3.1.0",
+    "pgvector>=0.2.0",
+]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "ruff>=0.1.0",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/reasongraph"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+
+[tool.ruff]
+target-version = "py311"
+line-length = 100