ragfly-cli 1.16.0__tar.gz

ragfly_cli-1.16.0/PKG-INFO

@@ -0,0 +1,73 @@
+Metadata-Version: 2.4
+Name: ragfly-cli
+Version: 1.16.0
+Summary: RAGfly CLI — operate RAGfly from the terminal and CI (login + cloud API). Lightweight, no desktop dependencies.
+Author: CAB Ltda
+License: Proprietary
+Project-URL: Homepage, https://ragfly.ai
+Project-URL: Documentation, https://api.ragfly.ai/docs
+Keywords: ragfly,rag,cli,retrieval,ai,mcp
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.1
+Requires-Dist: rich>=13.0
+Requires-Dist: httpx>=0.27
+Requires-Dist: keyring>=25.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pydantic-settings>=2.6
+
+# RAGfly CLI
+
+Operate RAGfly from the terminal and CI — `login` + the full `cloud` API surface
+against `api.ragfly.ai`. Lightweight: depends only on `click`, `rich`, `httpx`
+and `keyring`. **No desktop / PySide6 / OCR dependencies.**
+
+```bash
+pip install ragfly-cli
+ragfly version
+ragfly login
+ragfly cloud me
+```
+
+> This package ships the **`ragfly` binary** for scripting and automation.
+> It is distinct from `pip install ragfly` (the **Python SDK**, import `import ragfly`)
+> and from **RAGfly Desktop** (the DMG/exe that bundles the local file worker for
+> `ragfly local scan/sync/daemon`).
+
+## Authentication
+
+```bash
+# Interactive (JWT, stored in the OS keyring)
+ragfly login
+
+# Non-interactive / CI (API key, no expiry)
+export RAGFLY_TOKEN=slm_live_xxxxxxxxxx
+```
+
+## Command surface
+
+```
+ragfly
+├── login / logout / version
+└── cloud                    ← operations against api.ragfly.ai
+    ├── me
+    ├── grupo       listar | cambiar | limpiar
+    ├── documento   listar | ver
+    ├── espacio     listar | ver
+    ├── cola        ver | ejecuciones
+    ├── habilidad   listar | ver | ejecutar
+    ├── catalogo
+    ├── buscar
+    └── chat        preguntar
+```
+
+Full reference: <https://api.ragfly.ai/docs> and `docs/integradores/CLI.md`.
+
+> **Local operations** (`ragfly local scan/sync/daemon`) require the local file
+> worker and ship with **RAGfly Desktop**, not with this package.
+
+## Source
+
+The command logic is extracted from the RAGfly Desktop client
+(`cliente/ragfly/`). Canonical source of each module lives there; keep this
+package's copies in sync when the cloud command surface changes.

ragfly_cli-1.16.0/README.md

@@ -0,0 +1,55 @@
+# RAGfly CLI
+
+Operate RAGfly from the terminal and CI — `login` + the full `cloud` API surface
+against `api.ragfly.ai`. Lightweight: depends only on `click`, `rich`, `httpx`
+and `keyring`. **No desktop / PySide6 / OCR dependencies.**
+
+```bash
+pip install ragfly-cli
+ragfly version
+ragfly login
+ragfly cloud me
+```
+
+> This package ships the **`ragfly` binary** for scripting and automation.
+> It is distinct from `pip install ragfly` (the **Python SDK**, import `import ragfly`)
+> and from **RAGfly Desktop** (the DMG/exe that bundles the local file worker for
+> `ragfly local scan/sync/daemon`).
+
+## Authentication
+
+```bash
+# Interactive (JWT, stored in the OS keyring)
+ragfly login
+
+# Non-interactive / CI (API key, no expiry)
+export RAGFLY_TOKEN=slm_live_xxxxxxxxxx
+```
+
+## Command surface
+
+```
+ragfly
+├── login / logout / version
+└── cloud                    ← operations against api.ragfly.ai
+    ├── me
+    ├── grupo       listar | cambiar | limpiar
+    ├── documento   listar | ver
+    ├── espacio     listar | ver
+    ├── cola        ver | ejecuciones
+    ├── habilidad   listar | ver | ejecutar
+    ├── catalogo
+    ├── buscar
+    └── chat        preguntar
+```
+
+Full reference: <https://api.ragfly.ai/docs> and `docs/integradores/CLI.md`.
+
+> **Local operations** (`ragfly local scan/sync/daemon`) require the local file
+> worker and ship with **RAGfly Desktop**, not with this package.
+
+## Source
+
+The command logic is extracted from the RAGfly Desktop client
+(`cliente/ragfly/`). Canonical source of each module lives there; keep this
+package's copies in sync when the cloud command surface changes.

ragfly_cli-1.16.0/pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ragfly-cli"
+version = "1.16.0"
+description = "RAGfly CLI — operate RAGfly from the terminal and CI (login + cloud API). Lightweight, no desktop dependencies."
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "Proprietary" }
+authors = [{ name = "CAB Ltda" }]
+keywords = ["ragfly", "rag", "cli", "retrieval", "ai", "mcp"]
+
+dependencies = [
+    "click>=8.1",
+    "rich>=13.0",
+    "httpx>=0.27",
+    # JWT en el keyring del SO (Keychain macOS, Credential Manager Windows, libsecret Linux)
+    "keyring>=25.0",
+    "pydantic>=2.0",
+    "pydantic-settings>=2.6",
+]
+
+[project.urls]
+Homepage = "https://ragfly.ai"
+Documentation = "https://api.ragfly.ai/docs"
+
+[project.scripts]
+ragfly = "ragfly_cli.cli:app"
+
+[tool.setuptools.packages.find]
+include = ["ragfly_cli*"]

ragfly_cli-1.16.0/ragfly_cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.16.0"

ragfly_cli-1.16.0/ragfly_cli/__main__.py

@@ -0,0 +1,5 @@
+"""Permite `python -m ragfly_cli`."""
+from ragfly_cli.cli import app
+
+if __name__ == "__main__":
+    app()

ragfly_cli-1.16.0/ragfly_cli/_http.py

@@ -0,0 +1,67 @@
+"""
+Helpers HTTP comunes para todo el cliente.
+
+`default_headers()` — Headers que TODA request al backend cloud debe llevar:
+- `Authorization: Bearer <token>` (opcional; solo si token presente)
+- `Content-Type: application/json` (opcional, para writes)
+- `X-Client-Version: <__version__>` (siempre — el backend loggea y, en el
+  futuro, puede rechazar versiones incompatibles si ENFORCE_CLIENT_VERSION=true)
+
+Para usar:
+
+    from ragfly_cli._http import default_headers
+    headers = default_headers(token=jwt, content_type=True)
+    httpx.post(url, headers=headers, json=...)
+
+Notas:
+- Si tu request va a un servicio que NO es el backend cloud (ej: LLM externo
+  como Anthropic/Google/Ollama), NO uses esta función — usa los headers que
+  pida el proveedor.
+"""
+
+from __future__ import annotations
+
+from typing import Optional
+
+
+def default_headers(
+    *,
+    token: Optional[str] = None,
+    content_type: bool = False,
+    grupo_override: Optional[str] = None,
+) -> dict[str, str]:
+    """Construye los headers estándar para una request al backend cloud.
+
+    Args:
+        token: JWT (sin "Bearer " prefix). Si None, no agrega Authorization.
+        content_type: Si True, agrega Content-Type: application/json (writes).
+        grupo_override: Override explícito del grupo activo. Si None, se lee
+            de `ClienteConfig.codigo_grupo` (si está seteado).
+
+    Returns:
+        dict de headers listo para pasar a httpx.
+
+    El header `X-Override-Grupo` se envía cuando hay grupo activo configurado
+    o explícito. El backend lo respeta como override de sesión (mismo patrón
+    que el dropdown de grupo del frontend web).
+    """
+    from ragfly_cli import __version__ as _client_version
+
+    headers: dict[str, str] = {"X-Client-Version": _client_version}
+    if token:
+        headers["Authorization"] = f"Bearer {token}"
+    if content_type:
+        headers["Content-Type"] = "application/json"
+
+    # Resolver grupo activo: explícito > config
+    grupo = grupo_override
+    if grupo is None:
+        try:
+            from .config import get_config
+            grupo = get_config().codigo_grupo or None
+        except Exception:
+            grupo = None
+    if grupo:
+        headers["X-Override-Grupo"] = grupo
+
+    return headers