Metadata-Version: 2.4
Name: gogeo-client-agentos
Version: 0.2.6
Summary: AgentOS CLI tool for managing the AgentOS Client Docker container
Author-email: agentos-team <agentos@example.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/agentos/client
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# AgentOS Client

AgentOS Client Docker 容器管理 CLI 工具。

## 安装

```bash
pip install agentos
```

## 使用

### 首次安装/设置

```bash
# 方式一：直接设置（从环境变量或交互式输入读取 key）
agentos setup

# 方式二：命令行指定 key
agentos setup --key "your-nuwax-saved-key"

# 方式三：先设置环境变量
export NUWAX_SAVED_KEY="your-key"
agentos setup
```

setup 流程：
1. 检查 Docker 是否安装，未安装则自动安装（仅 Linux）
2. 拉取 agentos-client 镜像
3. 生成 docker-compose.yml 到 `~/.agentos/`
4. 保存 key 到 `~/.agentos/.env`

### 日常管理

```bash
agentos start      # 启动容器
agentos stop       # 停止容器
agentos restart    # 重启容器
agentos status     # 查看容器状态
agentos logs       # 查看最近 50 行日志
```

### 更新 key

```bash
agentos update-key "new-key-here"
agentos restart    # 重启生效
```

### 重新部署

```bash
agentos redeploy   # 删除旧配置，重新生成并重启
```

## 发布到 PyPI

```bash
# 安装构建工具
pip install build twine

# 构建
cd gogeo-client
python -m build

# 发布到 TestPyPI（测试）
python -m twine upload --repository testpypi dist/*

# 发布到 PyPI（正式）
python -m twine upload dist/*
```

## 目录结构

```
gogeo-client/
├── pyproject.toml          # Python 包配置
├── agentos/
│   ├── __init__.py
│   └── cli.py              # CLI 入口
├── app/                    # 应用覆盖文件
├── desktop/                # 桌面快捷方式
├── icons/                  # 桌面图标
├── wallpaper/              # 桌面壁纸
└── docker-compose.yml      # 本地开发用 compose
```
