AgentScale

使用单个命令将 Web 应用程序和 API 部署到公共 URL。

## Free Tier

- No signup or payment required to start.
- Run `npx agentscale register` to get an API key.
- Free deploys expire after 1 hour.
- Limited to 1 service.

## Paid Tier

- Add credits to remove the 1-hour expiry and deploy permanently.
- Use `npx agentscale account` to check your tier and credit balance.
- When you need to add credits, use the `agentspend pay` command or the AgentSpend skill.

## Commands

### Register

```bash
npx agentscale register
```

Generates an API key and saves it to `~/.agentscale/config.json`.

### Deploy

```bash
npx agentscale deploy
```

Run this from your project directory. Packages the current directory and deploys it.

**Options:**
- `--name <name>` — Service name (auto-generated if omitted)

### List

```bash
npx agentscale list
```

Lists your services and their status.

### Account

```bash
npx agentscale account
```

Shows your account tier (free/paid) and credit balance.

To add credits, use the `agentspend pay` command:

```bash
agentspend pay https://api.agentscale.co/add-credits \
  --header "x-api-key:<your-api-key>" \
  --body '{"amount_cents": 500}'
```

Or pay directly with an x402 wallet by calling `POST /add-credits` with your `x-api-key` header and `amount_cents` in the body.

## Project Requirements

- Deploy APIs and web services. Supports Node.js, Python, Go, and more.
- Your project needs a standard structure to be auto-detected:
  - **Node.js:** a `package.json` with a start script.
  - **Python:** a `requirements.txt`.
  - **Go:** a `go.mod`.
- Custom domains, build commands, and start commands are not yet supported.

## Environment Variables

- `AGENTSCALE_API_URL` — Overrides the default API base URL. **Warning:** this redirects all API calls, including those carrying your API key, to the specified URL.

## System Requirements

- `tar` must be available on PATH (used to package projects for deploy).

## Limits

- Upload: 100 MB compressed, 500 MB decompressed.

---

## 中文说明

## 免费层

- 无需注册或付款即可开始。
- 运行 `npx agentscale register` 获取 API 密钥。
- 免费部署在 1 小时后过期。
- 限制为 1 个服务。

## 付费层

- 添加额度以移除 1 小时过期限制并永久部署。
- 使用 `npx agentscale account` 查看你的层级和额度余额。
- 当你需要添加额度时，使用 `agentspend pay` 命令或 AgentSpend 技能。

## 命令

### Register

```bash
npx agentscale register
```

生成 API 密钥并将其保存到 `~/.agentscale/config.json`。

### Deploy

```bash
npx agentscale deploy
```

从你的项目目录运行此命令。打包当前目录并部署它。

**选项：**
- `--name <name>` — 服务名称（省略时自动生成）

### List

```bash
npx agentscale list
```

列出你的服务及其状态。

### Account

```bash
npx agentscale account
```

显示你的账户层级（免费/付费）和额度余额。

要添加额度，使用 `agentspend pay` 命令：

```bash
agentspend pay https://api.agentscale.co/add-credits \
  --header "x-api-key:<your-api-key>" \
  --body '{"amount_cents": 500}'
```

或者通过 x402 钱包直接付款，调用 `POST /add-credits`，在请求头中带上你的 `x-api-key`，并在请求体中带上 `amount_cents`。

## 项目要求

- 部署 API 和 Web 服务。支持 Node.js、Python、Go 等。
- 你的项目需要标准结构才能被自动检测：
  - **Node.js：** 带有 start 脚本的 `package.json`。
  - **Python：** 一个 `requirements.txt`。
  - **Go：** 一个 `go.mod`。
- 暂不支持自定义域名、构建命令和启动命令。

## 环境变量

- `AGENTSCALE_API_URL` — 覆盖默认的 API 基础 URL。**警告：** 这会将所有 API 调用（包括携带你 API 密钥的调用）重定向到指定的 URL。

## 系统要求

- `tar` 必须在 PATH 上可用（用于打包项目以便部署）。

## 限制

- 上传：压缩后 100 MB，解压后 500 MB。