ziro-core 0.2.6__tar.gz

ziro_core-0.2.6/.gitignore

@@ -0,0 +1,61 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+# generated by hatch-vcs at build time
+packages/ziro-core/src/ziro/_version.py
+tmp/
+.mypy_cache/
+**/.mypy_cache/
+
+# Virtual environments
+.venv
+# A second env for regenerating Linux-only UI snapshots from WSL, kept separate
+# so it never clobbers the Windows .venv sharing this working tree.
+.venv-linux
+
+# Local git worktrees
+.worktrees/
+
+# Environment variables
+.env
+# Next.js reads these; .env.example is committed as the template.
+.env.local
+.env*.local
+.mcp.json
+
+# Dev data (SQLite checkpoints and FAISS indexes)
+data/*.db
+data/*.db-*
+data/faiss_*/
+data/audit/
+data/voices/
+data/mcp_oauth/
+data/model_catalog.json
+data/models/
+data/*
+*.log
+snapshot_report.html
+data/threads.json
+data/threads.json.pre-flavour.bak
+
+# Node / pnpm / turborepo
+node_modules/
+.turbo/
+.pnpm-store/
+
+# Mintlify local build
+.mintlify/
+apps/docs/.mintlify/
+
+# Playwright MCP scratch output
+.playwright-mcp/
+
+# Next.js (apps/web)
+.next/
+next-env.d.ts
+.vercel/
+*.tsbuildinfo

ziro_core-0.2.6/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 hRupanjan
+
+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.

ziro_core-0.2.6/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: ziro-core
+Version: 0.2.6
+Summary: Ziro SDK — the agent engine (graph, tools, memory, RAG, guardrails, LLM adapters)
+Project-URL: Repository, https://github.com/hRupanjan/ziro
+Project-URL: Issues, https://github.com/hRupanjan/ziro/issues
+Author-email: hRupanjan <hrupanjan@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agent,langgraph,llm,memory,rag
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.11.9
+Requires-Dist: aiosqlite~=0.22.1
+Requires-Dist: ddgs<10,>=9
+Requires-Dist: faiss-cpu~=1.14.2
+Requires-Dist: httpx~=0.28.1
+Requires-Dist: langchain-anthropic~=1.4.8
+Requires-Dist: langchain-community~=0.4.2
+Requires-Dist: langchain-core~=1.4.6
+Requires-Dist: langchain-huggingface~=1.2.2
+Requires-Dist: langchain-mcp-adapters~=0.3.0
+Requires-Dist: langchain-openai~=1.3.0
+Requires-Dist: langchain-postgres~=0.0.17
+Requires-Dist: langchain-text-splitters~=1.1.2
+Requires-Dist: langchain~=1.3.9
+Requires-Dist: langfuse~=4.12.0
+Requires-Dist: langgraph-checkpoint-postgres~=3.1.0
+Requires-Dist: langgraph-checkpoint-sqlite~=3.1.0
+Requires-Dist: langgraph~=1.2.4
+Requires-Dist: langsmith~=0.8.18
+Requires-Dist: loguru~=0.7.3
+Requires-Dist: pathspec~=1.1.1
+Requires-Dist: psycopg[binary]~=3.3.4
+Requires-Dist: pypdf~=6.13.3
+Requires-Dist: python-dotenv~=1.2.2
+Requires-Dist: rich~=15.0.0
+Requires-Dist: sentence-transformers~=5.5.1
+Requires-Dist: torch~=2.13.0
+Requires-Dist: transformers~=5.12.0
+Provides-Extra: all
+Requires-Dist: faster-whisper~=1.2.1; extra == 'all'
+Requires-Dist: llama-cpp-python~=0.3.29; extra == 'all'
+Requires-Dist: piper-tts~=1.4.2; extra == 'all'
+Requires-Dist: presidio-analyzer~=2.2.362; extra == 'all'
+Requires-Dist: sounddevice~=0.5.5; extra == 'all'
+Provides-Extra: guardrails-local
+Requires-Dist: llama-cpp-python~=0.3.29; extra == 'guardrails-local'
+Requires-Dist: presidio-analyzer~=2.2.362; extra == 'guardrails-local'
+Provides-Extra: voice-local
+Requires-Dist: faster-whisper~=1.2.1; extra == 'voice-local'
+Requires-Dist: piper-tts~=1.4.2; extra == 'voice-local'
+Requires-Dist: sounddevice~=0.5.5; extra == 'voice-local'
+Description-Content-Type: text/markdown
+
+# ziro-core
+
+The Ziro SDK: the agent engine (LangGraph graph, progressive tools, memory,
+RAG, guardrails, compaction, LLM adapters). Import package: `ziro`.
+
+`pip install ziro` (the meta package) for the full TUI experience;
+`pip install ziro-core` for the embeddable SDK alone.

ziro_core-0.2.6/README.md

@@ -0,0 +1,7 @@
+# ziro-core
+
+The Ziro SDK: the agent engine (LangGraph graph, progressive tools, memory,
+RAG, guardrails, compaction, LLM adapters). Import package: `ziro`.
+
+`pip install ziro` (the meta package) for the full TUI experience;
+`pip install ziro-core` for the embeddable SDK alone.

ziro_core-0.2.6/pyproject.toml

@@ -0,0 +1,78 @@
+[project]
+name = "ziro-core"
+dynamic = ["version"]
+description = "Ziro SDK — the agent engine (graph, tools, memory, RAG, guardrails, LLM adapters)"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "hRupanjan", email = "hrupanjan@gmail.com" }]
+keywords = ["agent", "llm", "langgraph", "rag", "memory"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+requires-python = ">=3.11.9"
+dependencies = [
+    "langchain~=1.3.9",
+    "langchain-core~=1.4.6",
+    "langgraph~=1.2.4",
+    "langsmith~=0.8.18",
+    "langchain-openai~=1.3.0",
+    "langchain-huggingface~=1.2.2",
+    "sentence-transformers~=5.5.1",
+    "transformers~=5.12.0",
+    "torch~=2.13.0",
+    "langchain-community~=0.4.2",
+    "langchain-postgres~=0.0.17",
+    "faiss-cpu~=1.14.2",
+    "langchain-text-splitters~=1.1.2",
+    "pypdf~=6.13.3",
+    "aiosqlite~=0.22.1",
+    "langgraph-checkpoint-sqlite~=3.1.0",
+    "psycopg[binary]~=3.3.4",
+    "langgraph-checkpoint-postgres~=3.1.0",
+    "langchain-mcp-adapters~=0.3.0",
+    "langfuse~=4.12.0",
+    "httpx~=0.28.1",
+    "python-dotenv~=1.2.2",
+    "loguru~=0.7.3",
+    "rich~=15.0.0",
+    "langchain-anthropic~=1.4.8",
+    "pathspec~=1.1.1",
+    "ddgs>=9,<10",  # keyless DuckDuckGo backend for the native web_search tool
+]
+
+[project.optional-dependencies]
+guardrails-local = [
+    "presidio-analyzer~=2.2.362",
+    "llama-cpp-python~=0.3.29",
+]
+voice-local = [
+    "faster-whisper~=1.2.1",
+    "piper-tts~=1.4.2",
+    "sounddevice~=0.5.5",
+]
+all = ["ziro-core[guardrails-local,voice-local]"]
+
+[project.urls]
+Repository = "https://github.com/hRupanjan/ziro"
+Issues = "https://github.com/hRupanjan/ziro/issues"
+
+[build-system]
+requires = ["hatchling", "hatch-vcs"]
+build-backend = "hatchling.build"
+
+# Lockstep version from the ROOT repo's git tag.
+[tool.hatch.version]
+source = "vcs"
+raw-options = { root = "../.." }
+
+[tool.hatch.build.hooks.vcs]
+version-file = "src/ziro/_version.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/ziro"]

ziro_core-0.2.6/src/ziro/__init__.py

@@ -0,0 +1,63 @@
+"""Ziro — the public, semver'd Python SDK.
+
+``import ziro`` is the ONLY supported, documented surface. Everything under
+``app.*`` is internal and may change without a major-version bump. The SDK is a
+thin facade over the F12 ``TurnRunner`` shared turn core: it resolves a profile,
+builds the graph, and drives turns through the one resume loop the CLI also uses.
+
+Imports are **lazy** (PEP 562 module ``__getattr__``): ``import ziro`` pulls no
+torch / graph stack — those load only when you touch ``ziro.Ziro`` (i.e. when you
+actually build an agent). This keeps the SDK cheap to import in a host app.
+"""
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+__all__ = [
+    "Ziro",
+    "CapabilitiesHandle",
+    "TurnResult",
+    "StreamEvent",
+    "create_agent",
+    "Agent",
+    "AgentSpec",
+    "ToolConfig",
+    "Guardrails",
+    "PluginConfig",
+]
+
+try:
+    # Written at build time by hatch-vcs from the git tag (see pyproject.toml).
+    from ziro._version import __version__
+except ImportError:  # raw source tree with no tag / no VCS metadata
+    __version__ = "0.0.0+unknown"
+
+if TYPE_CHECKING:  # for type-checkers / IDEs only — no runtime import cost
+    from ziro.agent import Agent, Ziro, create_agent
+    from ziro.capabilities.handle import CapabilitiesHandle
+    from ziro.spec import AgentSpec, Guardrails, PluginConfig, ToolConfig
+    from ziro.types import StreamEvent, TurnResult
+
+
+def __getattr__(name: str):
+    if name in ("Ziro", "Agent", "create_agent"):
+        from ziro import agent
+
+        return getattr(agent, name)
+    if name in ("AgentSpec", "ToolConfig", "Guardrails", "PluginConfig"):
+        from ziro import spec
+
+        return getattr(spec, name)
+    if name == "CapabilitiesHandle":
+        from ziro.capabilities.handle import CapabilitiesHandle
+
+        return CapabilitiesHandle
+    if name in ("TurnResult", "StreamEvent"):
+        from ziro import types
+
+        return getattr(types, name)
+    raise AttributeError(f"module 'ziro' has no attribute {name!r}")
+
+
+def __dir__() -> list[str]:
+    return sorted(__all__)

ziro_core-0.2.6/src/ziro/_hf_bootstrap.py

@@ -0,0 +1,78 @@
+"""F24 — HuggingFace offline bootstrap (runs before any transformers/hub import).
+
+``huggingface_hub`` reads ``HF_HUB_OFFLINE`` into a module constant **once, at
+import time**, and it is imported very early (via
+``langchain_core.language_models.base`` → ``transformers``). Setting the env var any
+later has no effect (verified during implementation). The only chokepoint that runs
+before that import is ``app/__init__.py``, which calls :func:`configure_hf_offline`
+here.
+
+Going offline removes ~9 s of HuggingFace Hub revision/etag checks per launch (a
+cached-model construct drops from ~9.2 s to ~0.3 s) **and** pins the embedding space
+to the cached revision the FAISS index was built against. To stay correct on a fresh
+machine, we only go offline when the model is **already cached** (a pure filesystem
+check, no import) — otherwise the one-time download still runs. This module imports
+nothing but :mod:`os` so it can run before the heavy import web.
+"""
+
+from __future__ import annotations
+
+import os
+
+_EMB_MODEL = "sentence-transformers/all-MiniLM-L6-v2"
+
+
+def _hub_cache_dir() -> str:
+    """The HuggingFace hub cache directory, honouring the standard env overrides."""
+    cache = os.environ.get("HUGGINGFACE_HUB_CACHE")
+    if cache:
+        return cache
+    home = os.environ.get("HF_HOME") or os.path.join(
+        os.path.expanduser("~"), ".cache", "huggingface"
+    )
+    return os.path.join(home, "hub")
+
+
+def _embeddings_cached(model: str = _EMB_MODEL) -> bool:
+    """True iff a usable snapshot of ``model`` is already in the hub cache.
+
+    A usable snapshot carries ``config.json``; checking for it (rather than just the
+    snapshots dir) guards against a half-populated cache.
+    """
+    folder = "models--" + model.replace("/", "--")
+    snapshots = os.path.join(_hub_cache_dir(), folder, "snapshots")
+    if not os.path.isdir(snapshots):
+        return False
+    try:
+        for snap in os.listdir(snapshots):
+            if os.path.exists(os.path.join(snapshots, snap, "config.json")):
+                return True
+    except OSError:
+        return False
+    return False
+
+
+def configure_hf_offline() -> bool:
+    """Set ``HF_HUB_OFFLINE``/``TRANSFORMERS_OFFLINE`` when safe. Returns True iff
+    offline is in effect. MUST run before any ``huggingface_hub`` import.
+
+    Precedence: ``ZIRO_NO_ENV_MUTATION=1`` disables all host-env mutation (for
+    embedders — ``import ziro`` must not silently touch the host process env);
+    an explicit operator ``HF_HUB_OFFLINE`` is never overridden;
+    ``ZIRO_EMBEDDINGS_OFFLINE=1`` forces offline regardless of cache; otherwise
+    we go offline only when the embeddings model is already cached.
+    """
+    if os.environ.get("ZIRO_NO_ENV_MUTATION") == "1":
+        # Never write to the host env. Report the current offline state, but leave
+        # it to the operator to set HF_HUB_OFFLINE explicitly when embedding Ziro.
+        explicit_ro = os.environ.get("HF_HUB_OFFLINE")
+        return explicit_ro not in (None, "0", "", "false", "False")
+    explicit = os.environ.get("HF_HUB_OFFLINE")
+    if explicit is not None:  # respect an operator's explicit choice, either way
+        return explicit not in ("0", "", "false", "False")
+    forced = os.environ.get("ZIRO_EMBEDDINGS_OFFLINE", "") in ("1", "true", "True")
+    if forced or _embeddings_cached():
+        os.environ["HF_HUB_OFFLINE"] = "1"
+        os.environ["TRANSFORMERS_OFFLINE"] = "1"
+        return True
+    return False

ziro_core-0.2.6/src/ziro/_version.py

@@ -0,0 +1,24 @@
+# file generated by vcs-versioning
+# don't change, don't track in version control
+from __future__ import annotations
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+version: str
+__version__: str
+__version_tuple__: tuple[int | str, ...]
+version_tuple: tuple[int | str, ...]
+commit_id: str | None
+__commit_id__: str | None
+
+__version__ = version = '0.2.6'
+__version_tuple__ = version_tuple = (0, 2, 6)
+
+__commit_id__ = commit_id = None