crewai-sibfly 0.1.0__tar.gz

crewai_sibfly-0.1.0/LICENSE

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

crewai_sibfly-0.1.0/PKG-INFO

@@ -0,0 +1,73 @@
+Metadata-Version: 2.4
+Name: crewai-sibfly
+Version: 0.1.0
+Summary: CrewAI tool for SibFly — measured ground motion (subsidence & uplift) per US address, from NASA Sentinel-1 InSAR
+Author-email: SibFly <support@sibfly.com>
+License: MIT
+Project-URL: Homepage, https://sibfly.com
+Project-URL: Documentation, https://sibfly.com/docs
+Project-URL: Repository, https://github.com/james-sib/crewai-sibfly
+Keywords: crewai,crewai-tools,sibfly,insar,ground-motion,subsidence,geospatial,nasa,agents,tools
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: GIS
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: crewai>=0.70
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2.0
+Dynamic: license-file
+
+# crewai-sibfly
+
+A [CrewAI](https://github.com/crewAIInc/crewAI) tool for **[SibFly](https://sibfly.com)** — measured ground motion (subsidence & uplift) for any US address, in **mm/year**, from NASA OPERA Sentinel-1 satellite radar (InSAR). **Measured, not modeled.**
+
+Negative mm/year = the ground is sinking. Give your agents ground truth about whether the land under an address is sinking, rising, or stable.
+
+## Install
+
+```bash
+pip install -U crewai-sibfly
+export SIBFLY_API_KEY="sf_live_..."   # free key at https://sibfly.com (agents can self-register)
+```
+
+## Use
+
+```python
+from crewai import Agent
+from crewai_sibfly import SibflyGroundMotionTool
+
+analyst = Agent(
+    role="Property risk analyst",
+    goal="Tell the user if the ground under an address is sinking",
+    tools=[SibflyGroundMotionTool()],
+)
+```
+
+Or call it directly:
+
+```python
+from crewai_sibfly import SibflyGroundMotionTool
+
+tool = SibflyGroundMotionTool()                       # reads SIBFLY_API_KEY
+tool.run(address="1100 Congress Ave, Austin, TX")
+tool.run(lat=36.098, lon=-119.56, dry_run=True)       # FREE coverage + price check
+```
+
+## Pricing (agent-friendly)
+
+- **$0.40 per covered report.** Out-of-coverage, no-data, too-stale, and low-confidence results are **free** (`cost_usd: 0`).
+- Pass `dry_run=True` for a free coverage + price check before spending.
+- Route logic on the stable `assessment_code` (`rapid_subsidence` / `notable_subsidence` / `stable` / `mild_uplift` / `strong_uplift`), not the human-readable string.
+
+## Also available
+
+LangChain (`langchain-sibfly`), LlamaIndex (`llama-index-tools-sibfly`), n8n (`n8n-nodes-sibfly`), a hosted **MCP server** at `https://sibfly.com/mcp`, and a plain REST API. See <https://sibfly.com/docs>.
+
+Data: NASA OPERA DISP-S1 (contains modified Copernicus Sentinel data). Screening estimate from satellite radar, not an engineering survey. MIT-licensed integration.

crewai_sibfly-0.1.0/README.md

@@ -0,0 +1,47 @@
+# crewai-sibfly
+
+A [CrewAI](https://github.com/crewAIInc/crewAI) tool for **[SibFly](https://sibfly.com)** — measured ground motion (subsidence & uplift) for any US address, in **mm/year**, from NASA OPERA Sentinel-1 satellite radar (InSAR). **Measured, not modeled.**
+
+Negative mm/year = the ground is sinking. Give your agents ground truth about whether the land under an address is sinking, rising, or stable.
+
+## Install
+
+```bash
+pip install -U crewai-sibfly
+export SIBFLY_API_KEY="sf_live_..."   # free key at https://sibfly.com (agents can self-register)
+```
+
+## Use
+
+```python
+from crewai import Agent
+from crewai_sibfly import SibflyGroundMotionTool
+
+analyst = Agent(
+    role="Property risk analyst",
+    goal="Tell the user if the ground under an address is sinking",
+    tools=[SibflyGroundMotionTool()],
+)
+```
+
+Or call it directly:
+
+```python
+from crewai_sibfly import SibflyGroundMotionTool
+
+tool = SibflyGroundMotionTool()                       # reads SIBFLY_API_KEY
+tool.run(address="1100 Congress Ave, Austin, TX")
+tool.run(lat=36.098, lon=-119.56, dry_run=True)       # FREE coverage + price check
+```
+
+## Pricing (agent-friendly)
+
+- **$0.40 per covered report.** Out-of-coverage, no-data, too-stale, and low-confidence results are **free** (`cost_usd: 0`).
+- Pass `dry_run=True` for a free coverage + price check before spending.
+- Route logic on the stable `assessment_code` (`rapid_subsidence` / `notable_subsidence` / `stable` / `mild_uplift` / `strong_uplift`), not the human-readable string.
+
+## Also available
+
+LangChain (`langchain-sibfly`), LlamaIndex (`llama-index-tools-sibfly`), n8n (`n8n-nodes-sibfly`), a hosted **MCP server** at `https://sibfly.com/mcp`, and a plain REST API. See <https://sibfly.com/docs>.
+
+Data: NASA OPERA DISP-S1 (contains modified Copernicus Sentinel data). Screening estimate from satellite radar, not an engineering survey. MIT-licensed integration.

crewai_sibfly-0.1.0/crewai_sibfly/__init__.py

@@ -0,0 +1,12 @@
+"""CrewAI integration for SibFly — measured ground motion (subsidence/uplift) per US address."""
+from .client import SibflyClient
+
+__all__ = ["SibflyClient", "SibflyGroundMotionTool"]
+__version__ = "0.1.0"
+
+
+def __getattr__(name):   # lazy import so `SibflyClient` works even without crewai installed
+    if name == "SibflyGroundMotionTool":
+        from .tool import SibflyGroundMotionTool
+        return SibflyGroundMotionTool
+    raise AttributeError(name)

crewai_sibfly-0.1.0/crewai_sibfly/client.py

@@ -0,0 +1,83 @@
+"""Thin SibFly HTTP client (no crewai dependency, so it is easy to test)."""
+from __future__ import annotations
+import os
+from typing import Any, Dict, Optional
+import httpx
+
+DEFAULT_BASE_URL = "https://sibfly.com"
+_MOTION_PATH = "/api/v1/motion"
+_COVERAGE_PATH = "/api/v1/coverage"
+_DEFAULT_TIMEOUT = 60.0
+
+_KEEP = (
+    "status", "velocity_vertical_mm_yr", "velocity_vertical_in_yr", "velocity_uncertainty_mm_yr",
+    "seasonal_amplitude_mm", "total_motion_mm", "trend", "assessment", "assessment_code",
+    "confidence", "near_threshold", "neighbor_consistent", "data_age_days", "data_freshness",
+    "frame", "pixel_id", "n_measurements", "last_observation", "data_coverage", "coverage",
+    "cost_usd", "credits_remaining_usd", "would_cost_usd", "message", "request_id",
+)
+
+
+def _shape(payload: Any) -> Dict[str, Any]:
+    if not isinstance(payload, dict):
+        return {"raw": payload}
+    out = {k: payload[k] for k in _KEEP if payload.get(k) is not None}
+    for k in ("error", "code", "top_up_url", "buy_credits_url", "retryable", "retry_after"):
+        if payload.get(k) is not None:
+            out[k] = payload[k]
+    q = payload.get("query")
+    if isinstance(q, dict):
+        out["query"] = {k: q[k] for k in ("address", "geocoded_address", "lat", "lon") if q.get(k) is not None}
+    return out
+
+
+class SibflyClient:
+    """Minimal client for the SibFly ground-motion API.
+
+    Pricing is agent-friendly: $0.40 per covered report, and misses (out-of-coverage,
+    no-data, too-stale, low-confidence) return ``cost_usd: 0``. Use ``dry_run=True``
+    for a free coverage + price check first.
+    """
+
+    def __init__(self, api_key: Optional[str] = None, base_url: str = DEFAULT_BASE_URL,
+                 timeout: float = _DEFAULT_TIMEOUT) -> None:
+        self.api_key = api_key or os.environ.get("SIBFLY_API_KEY")
+        self.base_url = base_url.rstrip("/")
+        self.timeout = timeout
+
+    def _headers(self) -> Dict[str, str]:
+        if not self.api_key:
+            raise ValueError(
+                "A SibFly API key is required. Pass api_key=... or set SIBFLY_API_KEY. "
+                "Get a free key at https://sibfly.com (agents: POST /api/v1/autonomous/register)."
+            )
+        return {"Authorization": f"Bearer {self.api_key}", "Accept": "application/json"}
+
+    @staticmethod
+    def _handle(resp: "httpx.Response") -> Dict[str, Any]:
+        try:
+            body = resp.json()
+        except ValueError:
+            body = None
+        if resp.status_code >= 400:
+            if isinstance(body, dict) and (body.get("error") or body.get("code")):
+                return _shape(body)   # structured 402/429 etc. are actionable data
+            resp.raise_for_status()
+        return _shape(body)
+
+    def motion(self, address: Optional[str] = None, lat: Optional[float] = None,
+               lon: Optional[float] = None, dry_run: bool = False,
+               max_age_days: Optional[int] = None, min_confidence: Optional[float] = None) -> Dict[str, Any]:
+        if not address and (lat is None or lon is None):
+            raise ValueError("Provide an 'address' or both 'lat' and 'lon'.")
+        params: Dict[str, Any] = {}
+        if address:
+            params["address"] = address
+        else:
+            params["lat"] = lat; params["lon"] = lon
+        if dry_run: params["dry_run"] = 1
+        if max_age_days is not None: params["max_age_days"] = max_age_days
+        if min_confidence is not None: params["min_confidence"] = min_confidence
+        with httpx.Client() as c:
+            return self._handle(c.get(self.base_url + _MOTION_PATH, params=params,
+                                      headers=self._headers(), timeout=self.timeout))

crewai_sibfly-0.1.0/crewai_sibfly/tool.py

@@ -0,0 +1,55 @@
+"""SibFly ground-motion tool for CrewAI."""
+from __future__ import annotations
+from typing import Any, Dict, Optional, Type
+from pydantic import BaseModel, Field
+from crewai.tools import BaseTool
+from .client import SibflyClient, DEFAULT_BASE_URL
+
+
+class SibflyMotionInput(BaseModel):
+    address: Optional[str] = Field(
+        default=None, description="A US street address, e.g. '1100 Congress Ave, Austin, TX'. Provide this OR lat+lon.")
+    lat: Optional[float] = Field(default=None, description="Latitude (use with lon instead of address).")
+    lon: Optional[float] = Field(default=None, description="Longitude (use with lat instead of address).")
+    dry_run: bool = Field(default=False, description="If true, return a FREE preview (coverage + would_cost_usd), no charge.")
+    max_age_days: Optional[int] = Field(default=None, description="Return a free 'stale_data' result if the newest data is older than this.")
+    min_confidence: Optional[float] = Field(default=None, description="0-1. Return a free 'low_confidence' result below this pixel confidence.")
+
+
+class SibflyGroundMotionTool(BaseTool):
+    """Measure how fast the ground is sinking or rising (mm/year) under any US address.
+
+    Uses the SibFly API (NASA OPERA Sentinel-1 InSAR — measured, not modeled). Negative
+    mm/year = sinking. Returns velocity, uncertainty, a stable ``assessment_code``
+    (rapid_subsidence / notable_subsidence / stable / mild_uplift / strong_uplift),
+    confidence, and data age. $0.40 per covered report; out-of-coverage and low-quality
+    results are FREE. Pass ``dry_run=True`` for a free coverage + price check first.
+
+    Setup::
+
+        pip install -U crewai-sibfly
+        export SIBFLY_API_KEY="sf_live_..."   # free key at https://sibfly.com
+
+        from crewai_sibfly import SibflyGroundMotionTool
+        agent = Agent(role="Property risk analyst", tools=[SibflyGroundMotionTool()], ...)
+    """
+
+    name: str = "SibFly Ground Motion"
+    description: str = (
+        "Measure how fast the ground is sinking or rising (mm/year) under a US address, "
+        "from NASA satellite radar (InSAR). Input a US address OR lat/lon. Negative = sinking. "
+        "Returns velocity, uncertainty, a stable assessment_code (rapid_subsidence/"
+        "notable_subsidence/stable/mild_uplift/strong_uplift), confidence, and data age. "
+        "$0.40 per covered report; out-of-coverage and low-quality results are FREE. Pass "
+        "dry_run=true for a free coverage + price check first."
+    )
+    args_schema: Type[BaseModel] = SibflyMotionInput
+    api_key: Optional[str] = None
+    base_url: str = DEFAULT_BASE_URL
+
+    def _run(self, address: Optional[str] = None, lat: Optional[float] = None, lon: Optional[float] = None,
+             dry_run: bool = False, max_age_days: Optional[int] = None,
+             min_confidence: Optional[float] = None) -> Dict[str, Any]:
+        client = SibflyClient(api_key=self.api_key, base_url=self.base_url)
+        return client.motion(address=address, lat=lat, lon=lon, dry_run=dry_run,
+                             max_age_days=max_age_days, min_confidence=min_confidence)

crewai_sibfly-0.1.0/crewai_sibfly.egg-info/PKG-INFO

@@ -0,0 +1,73 @@
+Metadata-Version: 2.4
+Name: crewai-sibfly
+Version: 0.1.0
+Summary: CrewAI tool for SibFly — measured ground motion (subsidence & uplift) per US address, from NASA Sentinel-1 InSAR
+Author-email: SibFly <support@sibfly.com>
+License: MIT
+Project-URL: Homepage, https://sibfly.com
+Project-URL: Documentation, https://sibfly.com/docs
+Project-URL: Repository, https://github.com/james-sib/crewai-sibfly
+Keywords: crewai,crewai-tools,sibfly,insar,ground-motion,subsidence,geospatial,nasa,agents,tools
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: GIS
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: crewai>=0.70
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2.0
+Dynamic: license-file
+
+# crewai-sibfly
+
+A [CrewAI](https://github.com/crewAIInc/crewAI) tool for **[SibFly](https://sibfly.com)** — measured ground motion (subsidence & uplift) for any US address, in **mm/year**, from NASA OPERA Sentinel-1 satellite radar (InSAR). **Measured, not modeled.**
+
+Negative mm/year = the ground is sinking. Give your agents ground truth about whether the land under an address is sinking, rising, or stable.
+
+## Install
+
+```bash
+pip install -U crewai-sibfly
+export SIBFLY_API_KEY="sf_live_..."   # free key at https://sibfly.com (agents can self-register)
+```
+
+## Use
+
+```python
+from crewai import Agent
+from crewai_sibfly import SibflyGroundMotionTool
+
+analyst = Agent(
+    role="Property risk analyst",
+    goal="Tell the user if the ground under an address is sinking",
+    tools=[SibflyGroundMotionTool()],
+)
+```
+
+Or call it directly:
+
+```python
+from crewai_sibfly import SibflyGroundMotionTool
+
+tool = SibflyGroundMotionTool()                       # reads SIBFLY_API_KEY
+tool.run(address="1100 Congress Ave, Austin, TX")
+tool.run(lat=36.098, lon=-119.56, dry_run=True)       # FREE coverage + price check
+```
+
+## Pricing (agent-friendly)
+
+- **$0.40 per covered report.** Out-of-coverage, no-data, too-stale, and low-confidence results are **free** (`cost_usd: 0`).
+- Pass `dry_run=True` for a free coverage + price check before spending.
+- Route logic on the stable `assessment_code` (`rapid_subsidence` / `notable_subsidence` / `stable` / `mild_uplift` / `strong_uplift`), not the human-readable string.
+
+## Also available
+
+LangChain (`langchain-sibfly`), LlamaIndex (`llama-index-tools-sibfly`), n8n (`n8n-nodes-sibfly`), a hosted **MCP server** at `https://sibfly.com/mcp`, and a plain REST API. See <https://sibfly.com/docs>.
+
+Data: NASA OPERA DISP-S1 (contains modified Copernicus Sentinel data). Screening estimate from satellite radar, not an engineering survey. MIT-licensed integration.

crewai_sibfly-0.1.0/crewai_sibfly.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+crewai_sibfly/__init__.py
+crewai_sibfly/client.py
+crewai_sibfly/py.typed
+crewai_sibfly/tool.py
+crewai_sibfly.egg-info/PKG-INFO
+crewai_sibfly.egg-info/SOURCES.txt
+crewai_sibfly.egg-info/dependency_links.txt
+crewai_sibfly.egg-info/requires.txt
+crewai_sibfly.egg-info/top_level.txt

crewai_sibfly-0.1.0/crewai_sibfly.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

crewai_sibfly-0.1.0/crewai_sibfly.egg-info/requires.txt

@@ -0,0 +1,3 @@
+crewai>=0.70
+httpx>=0.27
+pydantic>=2.0

crewai_sibfly-0.1.0/crewai_sibfly.egg-info/top_level.txt

@@ -0,0 +1 @@
+crewai_sibfly

crewai_sibfly-0.1.0/pyproject.toml

@@ -0,0 +1,35 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "crewai-sibfly"
+version = "0.1.0"
+description = "CrewAI tool for SibFly — measured ground motion (subsidence & uplift) per US address, from NASA Sentinel-1 InSAR"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "SibFly", email = "support@sibfly.com" }]
+keywords = ["crewai", "crewai-tools", "sibfly", "insar", "ground-motion", "subsidence", "geospatial", "nasa", "agents", "tools"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering :: GIS",
+]
+dependencies = ["crewai>=0.70", "httpx>=0.27", "pydantic>=2.0"]
+
+[project.urls]
+Homepage = "https://sibfly.com"
+Documentation = "https://sibfly.com/docs"
+Repository = "https://github.com/james-sib/crewai-sibfly"
+
+[tool.setuptools]
+packages = ["crewai_sibfly"]
+
+[tool.setuptools.package-data]
+crewai_sibfly = ["py.typed"]

crewai_sibfly-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+