Metadata-Version: 2.4
Name: isage-cli
Version: 0.2.4.41
Summary: SAGE Command Line Interface — Unified CLI for SAGE platform (L3)
Author-email: IntelliStream Team <shuhao_zhang@hust.edu.cn>
License: MIT
Project-URL: Homepage, https://github.com/intellistream/sage-cli
Project-URL: Repository, https://github.com/intellistream/sage-cli
Project-URL: Issues, https://github.com/intellistream/sage-cli/issues
Keywords: sage,cli,command-line,streaming,ai,intellistream
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: isage-common>=0.2.5.0
Requires-Dist: isage-kernel>=0.2.5.0
Requires-Dist: isagellm>=0.1.0
Requires-Dist: isagellm-core>=0.1.0
Requires-Dist: typer<1.0.0,>=0.15.0
Requires-Dist: rich>=13.0.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: python-dotenv<2.0.0,>=1.1.0
Requires-Dist: requests<3.0.0,>=2.32.0
Requires-Dist: httpx<1.0.0,>=0.28.0
Requires-Dist: colorama>=0.4.6
Requires-Dist: tabulate<1.0.0,>=0.9.0
Requires-Dist: psutil>=5.9.0
Provides-Extra: full
Provides-Extra: dev
Requires-Dist: isage-cli[full]; extra == "dev"
Requires-Dist: pytest>=7.4.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Requires-Dist: ruff==0.15.4; extra == "dev"
Requires-Dist: pre-commit>=3.0.0; extra == "dev"
Requires-Dist: isage-pypi-publisher>=0.2.1.0; extra == "dev"
Dynamic: license-file

# SAGE CLI — isage-cli

[![PyPI version](https://badge.fury.io/py/isage-cli.svg)](https://badge.fury.io/py/isage-cli)
[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

**SAGE CLI** is the unified command-line interface for the SAGE platform (L5 Interface Layer).

## Layer Info

| Property | Value |
|---|---|
| Layer | **L5** (Interface Layer — top of the stack) |
| PyPI | `isage-cli` |
| Import | `sage.cli` |
| Depends on | `isage-common` (L1), `isage-kernel` (L3), `isage-middleware` (L4) |

## Features

- **App management** — run, stop, status for SAGE apps
- **LLM service control** — start, stop, status for LLM services
- **Cluster management** — head/worker node management
- **Pipeline management** — pipeline lifecycle commands
- **Platform utilities** — env, config, logs, extensions, doctor

## Installation

```bash
pip install isage-cli
```

## Quick Start

```bash
# Show all commands
sage --help

# Check environment
sage platform doctor

# Start LLM service
sage app llm start --model llama3
```

## Development Setup

```bash
git clone https://github.com/intellistream/sage-cli.git
cd sage-cli
./quickstart.sh --dev --yes
```

## Architecture

```
sage.cli (L5)
├── commands/
│   ├── apps/        — App-level commands (chat, embedding, gateway, inference, llm, pipeline)
│   └── platform/    — Platform commands (cluster, config, docs, doctor, env, job, logs, ...)
└── core/            — Base classes, config, exceptions, output utilities
```

## Related Repositories

| Package | Layer | Purpose |
|---|---|---|
| [isage-common](https://github.com/intellistream/sage-common) | L1 | Core utilities, config, logging |
| [isage-kernel](https://github.com/intellistream/sage-kernel) | L3 | Streaming runtime, scheduler, flow DSL |
| [isage-middleware](https://github.com/intellistream/sage-middleware) | L4 | Domain operators, service components |

## License

MIT — see [LICENSE](LICENSE).
