Metadata-Version: 2.4
Name: gspark-agent
Version: 0.5.1
Summary: G-spark / HUB Agent tools: CLI + MCP for /v1 API
Author: G-spark
License: Proprietary
Project-URL: Homepage, https://api.g-spark.cn
Project-URL: Documentation, https://api.g-spark.cn/agent
Keywords: gspark,hub,cli,mcp,agent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.27
Requires-Dist: typer>=0.12
Requires-Dist: rich>=13
Provides-Extra: mcp
Requires-Dist: mcp>=1.2; extra == "mcp"

# gspark-agent

面向 AI Agent 的 G-spark / HUB 接入工具：**CLI + MCP**，共用同一套 `/v1` 客户端。

## 安装

```bash
pip install "gspark-agent[mcp]"
# 或隔离安装
pipx install "gspark-agent[mcp]"
```

开发（本仓库）：

```bash
pip install "./packages/gspark-agent[mcp]"
```

## 配置

```bash
export GSPARK_API_KEY=sk_xxxx
export GSPARK_BASE_URL=https://api.g-spark.cn   # 或其他节点，如 https://api.hqszh.com
```

兼容别名：`HUB_API_KEY`、`HUB_BASE_URL`。

## CLI

```bash
gspark apps list --json
gspark apps show video_01 --json
gspark tasks estimate --app video_01 --input prompt="hello" --json
gspark tasks run --app video_01 --input prompt="hello" --wait --json
gspark tasks get <task_id> --json
gspark account balance --json
gspark account ledger --page 1 --size 20 --json
```

- `--json`：紧凑单行 JSON（便于 Agent / 管道）
- 默认：缩进 JSON；`account ledger` 默认为表格

`--input` 支持 JSON 数组/对象，例如：`--input tags='["a","b"]'`、`--input meta='{"k":1}'`。

## MCP（Cursor）

见 `agent_pack/mcp-config.example.json`；控制台「Agent 接入」页可下载完整接入包。

```bash
gspark-mcp
```

## Agent Skill

`agent_pack/SKILL.md` 为全站通用说明书，配合 CLI 使用；无需为每个应用单独复制文档。

## 许可

Proprietary — 允许安装使用；勿再分发改牌。
