sference-cli 0.1.3__tar.gz → 0.1.5__tar.gz

{sference_cli-0.1.3 → sference_cli-0.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sference-cli
-Version: 0.1.3
+Version: 0.1.5
 Summary: sference command-line interface
 Project-URL: Homepage, https://sference.com
 Project-URL: Repository, https://github.com/s-ference/sference
@@ -21,7 +21,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Utilities
 Requires-Python: >=3.10
-Requires-Dist: sference-sdk>=0.1.3
+Requires-Dist: sference-sdk>=0.1.5
 Requires-Dist: typer>=0.24.1
 Description-Content-Type: text/markdown
 

{sference_cli-0.1.3 → sference_cli-0.1.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sference-cli"
-version = "0.1.3"
+version = "0.1.5"
 description = "sference command-line interface"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -23,7 +23,7 @@ classifiers = [
 ]
 dependencies = [
     "typer>=0.24.1",
-    "sference-sdk>=0.1.3",
+    "sference-sdk>=0.1.5",
 ]
 
 [project.urls]

{sference_cli-0.1.3 → sference_cli-0.1.5}/sference_cli/main.py

@@ -32,11 +32,13 @@ batch_app = typer.Typer(help="Batch commands", invoke_without_command=True)
 stream_app = typer.Typer(help="Stream commands", invoke_without_command=True)
 responses_app = typer.Typer(help="Responses commands", invoke_without_command=True)
 models_app = typer.Typer(help="List models (GET /v1/models)", invoke_without_command=True)
+embeddings_app = typer.Typer(help="Embeddings commands", invoke_without_command=True)
 app.add_typer(auth_app, name="auth")
 app.add_typer(batch_app, name="batch")
 app.add_typer(stream_app, name="stream")
 app.add_typer(responses_app, name="responses")
 app.add_typer(models_app, name="models")
+app.add_typer(embeddings_app, name="embeddings")
 register_launch_commands(app)
 
 CREDENTIALS_PATH = Path.home() / ".sference" / "credentials.json"
@@ -148,7 +150,58 @@ def _print(value: object, as_json: bool) -> None:
 
 def _list_models(*, client: SferenceClient, as_json: bool) -> None:
     payload = _call_api(client.list_models)
-    typer.echo(json.dumps(payload, indent=None if as_json else 2))
+    if as_json:
+        typer.echo(json.dumps(payload, indent=2, default=str))
+        return
+    _print_models_table(payload)
+
+
+def _capability_flag(caps: object, key: str) -> str:
+    if not isinstance(caps, dict):
+        return "—"
+    entry = caps.get(key)
+    if isinstance(entry, dict) and "supported" in entry:
+        return "yes" if entry["supported"] else "no"
+    return "—"
+
+
+def _print_models_table(payload: object) -> None:
+    if not isinstance(payload, dict):
+        typer.echo(str(payload))
+        return
+    rows = payload.get("data")
+    if not isinstance(rows, list):
+        typer.echo(json.dumps(payload, indent=2, default=str))
+        return
+    if not rows:
+        typer.echo("No models.")
+        return
+
+    w_id, w_name, w_ctx, w_vis, w_pdf, w_think, w_tools = 34, 18, 8, 6, 4, 8, 5
+    typer.echo(
+        f"{'id':<{w_id}} {'display_name':<{w_name}} {'context':>{w_ctx}} "
+        f"{'vision':>{w_vis}} {'pdf':>{w_pdf}} {'thinking':>{w_think}} {'tools':>{w_tools}}"
+    )
+    for row in rows:
+        if not isinstance(row, dict):
+            continue
+        model_id = str(row.get("id", ""))
+        if len(model_id) > w_id:
+            model_id = model_id[: w_id - 3] + "..."
+        display_name = str(row.get("display_name") or "")
+        if len(display_name) > w_name:
+            display_name = display_name[: w_name - 1] + "…"
+        ctx_raw = row.get("context_tokens")
+        context = str(ctx_raw) if isinstance(ctx_raw, int) else "—"
+        caps = row.get("capabilities")
+        vision = _capability_flag(caps, "image_input")
+        pdf = _capability_flag(caps, "pdf_input")
+        thinking = _capability_flag(caps, "thinking")
+        tools = _capability_flag(caps, "tools")
+        typer.echo(
+            f"{model_id:<{w_id}} {display_name:<{w_name}} {context:>{w_ctx}} "
+            f"{vision:>{w_vis}} {pdf:>{w_pdf}} {thinking:>{w_think}} {tools:>{w_tools}}"
+        )
 
 
 def _window_choice(value: str) -> str:
@@ -235,6 +288,34 @@ def models_list(
     _list_models(client=client, as_json=as_json)
 
 
+@embeddings_app.command("create")
+def embeddings_create(
+    model: str = typer.Option(..., "--model"),
+    input_text: list[str] = typer.Option(..., "--input", help="Text to embed (repeat for multiple strings)."),
+    encoding_format: str = typer.Option("float", "--encoding-format", help='"float" or "base64".'),
+    dimensions: int | None = typer.Option(None, "--dimensions"),
+    timeout: float = typer.Option(600.0, "--timeout", help="HTTP read timeout in seconds."),
+    base_url: str = typer.Option("https://api.sference.com"),
+    as_json: bool = typer.Option(False, "--json"),
+) -> None:
+    """Create embeddings (POST /v1/embeddings)."""
+    _ensure_api_credential()
+    if encoding_format not in ("float", "base64"):
+        typer.echo('encoding_format must be "float" or "base64".', err=True)
+        raise typer.Exit(code=1)
+    inp: str | list[str] = input_text[0] if len(input_text) == 1 else input_text
+    client = _client(base_url, timeout=timeout)
+    resp = _call_api(
+        lambda: client.create_embeddings(
+            model=model,
+            input=inp,
+            encoding_format=encoding_format,  # type: ignore[arg-type]
+            dimensions=dimensions,
+        )
+    )
+    _print(resp.model_dump(), as_json or True)
+
+
 @auth_app.command("login")
 def auth_login(
     api_key: Optional[str] = typer.Option(