krail 0.2.1__tar.gz

krail-0.2.1/PKG-INFO

@@ -0,0 +1,74 @@
+Metadata-Version: 2.4
+Name: krail
+Version: 0.2.1
+Summary: KRAIL client for local projects and the local API runtime
+Author: AkeBoss Tech
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/AkeBoss-tech/knowledge
+Project-URL: Repository, https://github.com/AkeBoss-tech/knowledge
+Project-URL: Issues, https://github.com/AkeBoss-tech/knowledge/issues
+Keywords: knowledge,research,agents,local-first,mcp
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+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 :: Information Analysis
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2
+Requires-Dist: pyyaml>=6
+Provides-Extra: analysis
+Requires-Dist: numpy; extra == "analysis"
+Requires-Dist: pandas; extra == "analysis"
+Requires-Dist: statsmodels; extra == "analysis"
+Requires-Dist: matplotlib; extra == "analysis"
+Provides-Extra: local
+Requires-Dist: owlready2; extra == "local"
+Requires-Dist: duckdb; extra == "local"
+Provides-Extra: embeddings
+Requires-Dist: sentence-transformers>=2.7; extra == "embeddings"
+
+# krail
+
+KRAIL client supporting local project mode and the local FastAPI runtime.
+
+Install from PyPI:
+
+```bash
+pip install krail
+```
+
+The distribution is named `krail`; the Python import namespace remains `rail`.
+
+## Usage Examples
+
+```python
+import rail
+
+# API mode
+project = rail.connect("nj-economics")
+
+# DataFrame queries
+df = project.query("SELECT county_name, unemployment_rate FROM County ORDER BY unemployment_rate DESC LIMIT 10")
+
+# Agent research
+answer = project.agent.ask("What counties had unemployment above 10% in 2020?")
+print(answer)
+
+# Streaming agent
+for event in project.agent.ask("Compare Hudson and Bergen County unemployment trends", stream=True):
+    if event["type"] == "text_delta":
+        print(event["text"], end="", flush=True)
+
+# Direct local mode
+project = rail.local("./nj-economics")
+ont = project.ontology()
+counties = ont.individuals("County")
+print(f"Loaded {len(counties)} counties")
+```

krail-0.2.1/README.md

@@ -0,0 +1,38 @@
+# krail
+
+KRAIL client supporting local project mode and the local FastAPI runtime.
+
+Install from PyPI:
+
+```bash
+pip install krail
+```
+
+The distribution is named `krail`; the Python import namespace remains `rail`.
+
+## Usage Examples
+
+```python
+import rail
+
+# API mode
+project = rail.connect("nj-economics")
+
+# DataFrame queries
+df = project.query("SELECT county_name, unemployment_rate FROM County ORDER BY unemployment_rate DESC LIMIT 10")
+
+# Agent research
+answer = project.agent.ask("What counties had unemployment above 10% in 2020?")
+print(answer)
+
+# Streaming agent
+for event in project.agent.ask("Compare Hudson and Bergen County unemployment trends", stream=True):
+    if event["type"] == "text_delta":
+        print(event["text"], end="", flush=True)
+
+# Direct local mode
+project = rail.local("./nj-economics")
+ont = project.ontology()
+counties = ont.individuals("County")
+print(f"Loaded {len(counties)} counties")
+```

krail-0.2.1/krail.egg-info/PKG-INFO

@@ -0,0 +1,74 @@
+Metadata-Version: 2.4
+Name: krail
+Version: 0.2.1
+Summary: KRAIL client for local projects and the local API runtime
+Author: AkeBoss Tech
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/AkeBoss-tech/knowledge
+Project-URL: Repository, https://github.com/AkeBoss-tech/knowledge
+Project-URL: Issues, https://github.com/AkeBoss-tech/knowledge/issues
+Keywords: knowledge,research,agents,local-first,mcp
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+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 :: Information Analysis
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2
+Requires-Dist: pyyaml>=6
+Provides-Extra: analysis
+Requires-Dist: numpy; extra == "analysis"
+Requires-Dist: pandas; extra == "analysis"
+Requires-Dist: statsmodels; extra == "analysis"
+Requires-Dist: matplotlib; extra == "analysis"
+Provides-Extra: local
+Requires-Dist: owlready2; extra == "local"
+Requires-Dist: duckdb; extra == "local"
+Provides-Extra: embeddings
+Requires-Dist: sentence-transformers>=2.7; extra == "embeddings"
+
+# krail
+
+KRAIL client supporting local project mode and the local FastAPI runtime.
+
+Install from PyPI:
+
+```bash
+pip install krail
+```
+
+The distribution is named `krail`; the Python import namespace remains `rail`.
+
+## Usage Examples
+
+```python
+import rail
+
+# API mode
+project = rail.connect("nj-economics")
+
+# DataFrame queries
+df = project.query("SELECT county_name, unemployment_rate FROM County ORDER BY unemployment_rate DESC LIMIT 10")
+
+# Agent research
+answer = project.agent.ask("What counties had unemployment above 10% in 2020?")
+print(answer)
+
+# Streaming agent
+for event in project.agent.ask("Compare Hudson and Bergen County unemployment trends", stream=True):
+    if event["type"] == "text_delta":
+        print(event["text"], end="", flush=True)
+
+# Direct local mode
+project = rail.local("./nj-economics")
+ont = project.ontology()
+counties = ont.individuals("County")
+print(f"Loaded {len(counties)} counties")
+```

krail-0.2.1/krail.egg-info/SOURCES.txt

@@ -0,0 +1,44 @@
+README.md
+pyproject.toml
+krail.egg-info/PKG-INFO
+krail.egg-info/SOURCES.txt
+krail.egg-info/dependency_links.txt
+krail.egg-info/entry_points.txt
+krail.egg-info/requires.txt
+krail.egg-info/top_level.txt
+rail/__init__.py
+rail/agent.py
+rail/bootstrap.py
+rail/cli.py
+rail/client.py
+rail/completion_gate.py
+rail/exceptions.py
+rail/integrity.py
+rail/knowledge.py
+rail/local.py
+rail/manifest.py
+rail/markdown_graph.py
+rail/models.py
+rail/modes.py
+rail/ontology.py
+rail/planner_sync.py
+rail/project.py
+rail/session_state.py
+rail/source_dependencies.py
+rail/vector_store.py
+rail/verification.py
+tests/test_bootstrap.py
+tests/test_cli.py
+tests/test_completion_gate.py
+tests/test_integrity.py
+tests/test_issue_intake.py
+tests/test_knowledge_modes.py
+tests/test_local_hydration_alignment.py
+tests/test_manifest.py
+tests/test_markdown_graph.py
+tests/test_planner_sync.py
+tests/test_session_state.py
+tests/test_source_dependencies.py
+tests/test_think.py
+tests/test_verification.py
+tests/test_workflows.py

krail-0.2.1/krail.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

krail-0.2.1/krail.egg-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+krail = rail.cli:main
+rail = rail.cli:main

krail-0.2.1/krail.egg-info/requires.txt

@@ -0,0 +1,16 @@
+httpx>=0.27
+pydantic>=2
+pyyaml>=6
+
+[analysis]
+numpy
+pandas
+statsmodels
+matplotlib
+
+[embeddings]
+sentence-transformers>=2.7
+
+[local]
+owlready2
+duckdb

krail-0.2.1/krail.egg-info/top_level.txt

@@ -0,0 +1 @@
+rail

krail-0.2.1/pyproject.toml

@@ -0,0 +1,50 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "krail"
+version = "0.2.1"
+description = "KRAIL client for local projects and the local API runtime"
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+authors = [
+    { name = "AkeBoss Tech" },
+]
+keywords = ["knowledge", "research", "agents", "local-first", "mcp"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Information Analysis",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "httpx>=0.27",
+    "pydantic>=2",
+    "pyyaml>=6",
+]
+
+[project.urls]
+Homepage = "https://github.com/AkeBoss-tech/knowledge"
+Repository = "https://github.com/AkeBoss-tech/knowledge"
+Issues = "https://github.com/AkeBoss-tech/knowledge/issues"
+
+[project.optional-dependencies]
+analysis = ["numpy", "pandas", "statsmodels", "matplotlib"]
+local = ["owlready2", "duckdb"]
+embeddings = ["sentence-transformers>=2.7"]
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["rail*"]
+
+[project.scripts]
+rail = "rail.cli:main"
+krail = "rail.cli:main"

krail-0.2.1/rail/__init__.py

@@ -0,0 +1,53 @@
+from rail.project import Project
+from rail.client import CloudClient
+from rail.local import LocalEngine
+from rail.integrity import (
+    ArtifactLineageRecord,
+    AssumptionRecord,
+    ClaimRecord,
+    IntegrityIndexes,
+    ResearchIntegrityRepo,
+    SourceRecord,
+    VerificationRunRecord,
+)
+from rail.manifest import (
+    ContractViolation,
+    ManifestValidationError,
+    RailManifest,
+    boot_validate_project,
+    load_and_validate_manifest,
+    load_manifest,
+    parse_manifest_content,
+)
+from rail.session_state import (
+    ACTIVE_STATUSES,
+    TERMINAL_STATUSES,
+    is_active_status,
+    is_terminal_status,
+    normalize_session_record,
+    normalize_session_status,
+)
+from rail.exceptions import RailError
+
+__version__ = "0.2.1"
+
+def connect(
+    slug: str,
+    api_url: str | None = None,
+    api_key: str | None = None,
+) -> Project:
+    """Connect to a KRAIL project via the local FastAPI runtime."""
+    import os
+    url = api_url or os.environ.get("RAIL_API_URL", "http://localhost:8000/api/v1")
+    key = api_key or os.environ.get("RAIL_API_KEY", "")
+    client = CloudClient(base_url=url, api_key=key)
+    return Project(slug=slug, backend=client)
+
+def local(
+    path: str = ".",
+    engine_path: str | None = None,
+) -> Project:
+    """Load a KRAIL project from a local repo directory."""
+    engine = LocalEngine(project_path=path, engine_path=engine_path)
+    slug = engine.read_rail_yaml().project.slug
+    return Project(slug=slug, backend=engine)

krail-0.2.1/rail/agent.py

@@ -0,0 +1,59 @@
+import json
+import httpx
+from typing import Generator, AsyncGenerator
+
+class AgentClient:
+    def __init__(self, base_url: str, project_slug: str, api_key: str = ""):
+        self.base_url = base_url.rstrip("/")
+        self.project_slug = project_slug
+        self.headers = {"Authorization": f"Bearer {api_key}"} if api_key else {}
+
+    def ask(self, question: str, stream: bool = False, model: str | None = None):
+        """Ask a question. Returns full answer text (stream=False) or event generator (stream=True)."""
+        if stream:
+            return self._stream(question, model)
+        else:
+            return self._blocking(question, model)
+
+    def _blocking(self, question: str, model: str | None) -> str:
+        """Collect all text_delta events and return the full answer."""
+        text = []
+        for event in self._stream(question, model):
+            if event.get("type") == "text_delta":
+                text.append(event.get("text", ""))
+        return "".join(text)
+
+    def _stream(self, question: str, model: str | None) -> Generator[dict, None, None]:
+        """Yield raw SSE event dicts."""
+        url = f"{self.base_url}/agent/chat?project={self.project_slug}"
+        payload = {"message": question, "history": []}
+        if model:
+            payload["model"] = model
+
+        with httpx.Client(timeout=300) as client:
+            with client.stream("POST", url, json=payload, headers=self.headers) as resp:
+                resp.raise_for_status()
+                for line in resp.iter_lines():
+                    if line.startswith("data: "):
+                        try:
+                            event = json.loads(line[6:])
+                            yield event
+                        except json.JSONDecodeError:
+                            pass
+
+    async def ask_async(self, question: str, model: str | None = None) -> AsyncGenerator[dict, None]:
+        """Async streaming version."""
+        url = f"{self.base_url}/agent/chat?project={self.project_slug}"
+        payload = {"message": question, "history": []}
+        if model:
+            payload["model"] = model
+
+        async with httpx.AsyncClient(timeout=300) as client:
+            async with client.stream("POST", url, json=payload, headers=self.headers) as resp:
+                resp.raise_for_status()
+                async for line in resp.aiter_lines():
+                    if line.startswith("data: "):
+                        try:
+                            yield json.loads(line[6:])
+                        except json.JSONDecodeError:
+                            pass