ailtir-cli 1.0.1__py3-none-any.whl

ailtir_cli/app.py

@@ -0,0 +1,3 @@
+import typer
+
+app = typer.Typer(name="ailtir", help="The Ailtir CLI", no_args_is_help=True)

ailtir_cli/commands/__init__.py

@@ -0,0 +1,5 @@
+import ailtir_cli.commands.analyse  # noqa: F401
+import ailtir_cli.commands.chat  # noqa: F401
+import ailtir_cli.commands.list_kbs  # noqa: F401
+import ailtir_cli.commands.upload  # noqa: F401
+import ailtir_cli.commands.version  # noqa: F401

ailtir_cli/commands/analyse.py

@@ -0,0 +1,35 @@
+import httpx
+import structlog
+import typer
+from rich.console import Console
+
+from ailtir_cli.app import app
+from ailtir_cli.config import settings
+
+_log = structlog.get_logger(__name__)
+_console = Console()
+
+
+@app.command()
+def analyse(kb_id: str = typer.Argument(..., help="The knowledge base ID to analyse.")) -> None:
+    """Trigger analysis and Knowledge Base creation for an uploaded ZIP."""
+    _console.print(f"Starting analysis for kb_id: [bold]{kb_id}[/bold]...")
+
+    token = settings.ailtir_cli_secret
+
+    with httpx.Client(base_url=settings.cli_api_url, timeout=30.0) as http:
+        try:
+            resp = http.post(
+                f"/kb/{kb_id}/analyse",
+                headers={"Authorization": f"Bearer {token}"},
+            )
+            resp.raise_for_status()
+        except httpx.HTTPStatusError as exc:
+            _console.print(f"[red]Error: {exc.response.status_code}[/red]")
+            raise typer.Exit(1) from exc
+
+    _log.info("analyse.started", kb_id=kb_id)
+    _console.print(
+        f"[green]Analysis started[/green] for kb_id: [bold]{kb_id}[/bold]. "
+        "This typically takes a few minutes. Use [bold]ailtir list[/bold] to check status."
+    )

ailtir_cli/commands/chat.py

@@ -0,0 +1,37 @@
+import httpx
+import structlog
+import typer
+from rich.console import Console
+
+from ailtir_cli.app import app
+from ailtir_cli.config import settings
+
+_log = structlog.get_logger(__name__)
+_console = Console()
+
+
+@app.command()
+def chat(
+    kb_id: str = typer.Argument(..., help="The knowledge base ID to query."),
+    question: str = typer.Argument(..., help="Your natural-language question."),
+) -> None:
+    """Ask a question answered using documents in a knowledge base (RAG)."""
+    _console.print(f"Querying kb_id: [bold]{kb_id}[/bold]...")
+
+    token = settings.ailtir_cli_secret
+
+    with httpx.Client(base_url=settings.cli_api_url, timeout=60.0) as http:
+        try:
+            resp = http.post(
+                f"/kb/{kb_id}/chat",
+                json={"question": question},
+                headers={"Authorization": f"Bearer {token}"},
+            )
+            resp.raise_for_status()
+        except httpx.HTTPStatusError as exc:
+            _console.print(f"[red]Error: {exc.response.status_code}[/red]")
+            raise typer.Exit(1) from exc
+
+    data = resp.json()
+    _log.info("chat.answered", kb_id=kb_id)
+    _console.print(data.get("answer", "No answer returned."))

ailtir_cli/commands/list_kbs.py

@@ -0,0 +1,41 @@
+import httpx
+import structlog
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from ailtir_cli.app import app
+from ailtir_cli.config import settings
+
+_log = structlog.get_logger(__name__)
+_console = Console()
+
+
+@app.command(name="list")
+def list_kbs() -> None:
+    """List all knowledge bases in your Ailtir account."""
+    token = settings.ailtir_cli_secret
+
+    with httpx.Client(base_url=settings.cli_api_url, timeout=30.0) as http:
+        try:
+            resp = http.get("/kb", headers={"Authorization": f"Bearer {token}"})
+            resp.raise_for_status()
+        except httpx.HTTPStatusError as exc:
+            _console.print(f"[red]Error: {exc.response.status_code}[/red]")
+            raise typer.Exit(1) from exc
+
+    kbs = resp.json()
+    if not kbs:
+        _console.print("No knowledge bases found.")
+        return
+
+    table = Table(title="Knowledge Bases")
+    table.add_column("ID", style="dim")
+    table.add_column("Name")
+    table.add_column("Status")
+
+    for kb in kbs:
+        table.add_row(str(kb.get("id", "")), str(kb.get("name", "")), str(kb.get("status", "")))
+
+    _log.info("list_kbs.returned", count=len(kbs))
+    _console.print(table)

ailtir_cli/commands/upload.py

@@ -0,0 +1,66 @@
+import pathlib
+
+import httpx
+import structlog
+import typer
+from rich.console import Console
+
+from ailtir_cli.app import app
+from ailtir_cli.config import settings
+
+_log = structlog.get_logger(__name__)
+_console = Console()
+
+
+@app.command()
+def upload(
+    file_path: str = typer.Argument(..., help="Absolute path to the ZIP file to upload."),
+) -> None:
+    """Upload a ZIP archive of documents to Ailtir storage."""
+    path = pathlib.Path(file_path)
+    if not path.is_absolute():
+        _console.print("[red]Error: file_path must be an absolute path.[/red]")
+        raise typer.Exit(1)
+    if not path.exists():
+        _console.print(f"[red]Error: file not found: {file_path}[/red]")
+        raise typer.Exit(1)
+    if not path.is_file():
+        _console.print(f"[red]Error: not a file: {file_path}[/red]")
+        raise typer.Exit(1)
+
+    _console.print(f"Uploading [bold]{path.name}[/bold]...")
+
+    content = path.read_bytes()
+    token = settings.ailtir_cli_secret
+
+    with httpx.Client(base_url=settings.cli_api_url, timeout=30.0) as http:
+        try:
+            reg_resp = http.post(
+                "/kb",
+                json={"file_name": path.name},
+                headers={"Authorization": f"Bearer {token}"},
+            )
+            reg_resp.raise_for_status()
+        except httpx.HTTPStatusError as exc:
+            _console.print(f"[red]Error registering KB: {exc.response.status_code}[/red]")
+            raise typer.Exit(1) from exc
+
+    reg = reg_resp.json()
+    kb_id: str = reg["kb_id"]
+    upload_url: str = reg["upload_url"]
+
+    # PUT directly to S3 via the presigned URL — no auth header, S3 auth is in the URL.
+    with httpx.Client(timeout=None) as s3_client:  # noqa: S113
+        try:
+            s3_resp = s3_client.put(
+                upload_url,
+                content=content,
+                headers={"Content-Type": "application/zip"},
+            )
+            s3_resp.raise_for_status()
+        except httpx.HTTPStatusError as exc:
+            _console.print(f"[red]Error uploading to S3: {exc.response.status_code}[/red]")
+            raise typer.Exit(1) from exc
+
+    _log.info("upload.done", kb_id=kb_id)
+    _console.print(f"[green]Upload complete.[/green] kb_id: [bold]{kb_id}[/bold]")

ailtir_cli/commands/version.py

@@ -0,0 +1,13 @@
+from importlib.metadata import version
+
+from rich.console import Console
+
+from ailtir_cli.app import app
+
+_console = Console()
+
+
+@app.command(name="version")
+def get_version() -> None:
+    """Print the version of the ailtir CLI."""
+    _console.print(version("ailtir-cli"))

ailtir_cli/config.py

@@ -0,0 +1,14 @@
+from pydantic import Field
+from pydantic_settings import BaseSettings, SettingsConfigDict
+
+
+class Settings(BaseSettings):
+    ailtir_cli_secret: str = Field(..., min_length=1)
+    cli_api_url: str = Field(default="https://app.ailtir.ai/cli-api")
+    log_format: str = Field(default="console")
+    log_level: str = Field(default="INFO")
+
+    model_config = SettingsConfigDict(env_file=".env", extra="ignore")
+
+
+settings = Settings()  # type: ignore[call-arg]

ailtir_cli/main.py

@@ -0,0 +1,7 @@
+"""Entrypoint for the ailtir CLI."""
+
+import ailtir_cli.commands  # noqa: F401 — registers all commands on app
+from ailtir_cli.app import app
+
+if __name__ == "__main__":
+    app()

ailtir_cli-1.0.1.dist-info/METADATA

@@ -0,0 +1,52 @@
+Metadata-Version: 2.4
+Name: ailtir-cli
+Version: 1.0.1
+Summary: Ailtir CLI — upload, analyse, list, and chat with knowledge bases
+License-Expression: MIT
+Project-URL: Homepage, https://ailtir.ai
+Project-URL: Repository, https://github.com/Team-Ailtir/ailtir-cli
+Keywords: cli,ailtir,knowledge-base,rag
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: pydantic-settings>=2.10.1
+Requires-Dist: rich>=14.0.0
+Requires-Dist: structlog>=25.4.0
+Requires-Dist: typer>=0.15.0
+Dynamic: license-file
+
+# ailtir-cli
+
+A CLI tool for interacting with Ailtir knowledge bases. Upload documents, trigger analysis, and query your knowledge bases from the terminal.
+
+## What is ailtir-cli?
+
+The Ailtir CLI provides commands for:
+- **upload**: Upload a ZIP archive of documents to Ailtir storage
+- **analyse**: Trigger knowledge base creation and analysis
+- **list**: List all knowledge bases in your account
+- **chat**: Ask questions answered using documents in a knowledge base (RAG)
+- **version**: Print the CLI version
+
+## Installation
+
+```sh
+uv tool install ailtir-cli
+```
+
+See [docs/index.html](./docs/index.html) for the full customer-facing installation guide.
+
+## Documentation
+
+- See [docs/index.html](./docs/index.html) for installation and usage guide (published at GitHub Pages)
+- See [CLAUDE.md][] for architecture and implementation details
+- See [CONTRIBUTING.md][] for development workflow and how to contribute
+
+## License
+
+MIT
+
+[CLAUDE.md]: ./CLAUDE.md
+[CONTRIBUTING.md]: ./CONTRIBUTING.md

ailtir_cli-1.0.1.dist-info/RECORD

@@ -0,0 +1,16 @@
+ailtir_cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ailtir_cli/app.py,sha256=o4Mn3tRqtJmI9_DGx-pbhrr_Ouwv38XC80Bk6Zx3Buo,92
+ailtir_cli/config.py,sha256=3zjI7rKNvaEZwAYnEKq6bUxEIYnAzXwHm3XKVFs4kBk,458
+ailtir_cli/main.py,sha256=BeRfiMiNLMqJxAUxods96vZF2e4uo8sNFNhzndOhfCk,182
+ailtir_cli/commands/__init__.py,sha256=Bs1u1rQqedRMWSqof928eXiLhSlGbHt_s3BQRmZ0RY8,242
+ailtir_cli/commands/analyse.py,sha256=HvWXS-rk6q89j-w4Fp8kiud42i_hPrgh1PD0qK316fw,1189
+ailtir_cli/commands/chat.py,sha256=hRPYcsAfCDTkSNzWkQW0lPCAvnYEyvWwDWiD_1IZJrA,1190
+ailtir_cli/commands/list_kbs.py,sha256=5xgjTK6euwTRLxxYrWR3aHW9gu4gnnYprPNL64FKD5A,1200
+ailtir_cli/commands/upload.py,sha256=HD4Fc0STI43-Ml3OROlWkXloE3jT34njZ-z_ok7nuP0,2244
+ailtir_cli/commands/version.py,sha256=94-M7A_SKaW_vSVa3s9_xVeonlF06TsrfHnivLPDk3o,274
+ailtir_cli-1.0.1.dist-info/licenses/LICENSE,sha256=qAMoBe2jj2QIBIKUzf93gZ-JBkxh03K_lru8hrSyCHw,922
+ailtir_cli-1.0.1.dist-info/METADATA,sha256=m1KugtxP1RgETnRSbNgVQZuWXgMqoe3PMEq2jqVh55E,1621
+ailtir_cli-1.0.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+ailtir_cli-1.0.1.dist-info/entry_points.txt,sha256=y-rMue-jrKX0h1AdnJPU15mfTOZjpVHYD9T9CjM4Qs0,47
+ailtir_cli-1.0.1.dist-info/top_level.txt,sha256=4w455lK_b-sAdT_FA4bxWam9WZj-YMVSQaW6Ds7_77I,11
+ailtir_cli-1.0.1.dist-info/RECORD,,

ailtir_cli-1.0.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

ailtir_cli-1.0.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ailtir = ailtir_cli.main:app

ailtir_cli-1.0.1.dist-info/licenses/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2025 Ailtir
+
+All rights reserved.
+
+This software and associated documentation files (the "Software") are proprietary
+and confidential to Ailtir.
+
+Permission is hereby granted to employees and authorized contractors of Ailtir
+to use, copy, and modify the Software for internal business purposes only.
+
+Redistribution, publication, or disclosure of the Software to third parties
+is strictly prohibited without prior written permission from Ailtir.
+
+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.

ailtir_cli-1.0.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+ailtir_cli