AgentOS Client

AgentOS Client Docker 容器管理 CLI 工具。

安装

pip install agentos

使用

首次安装/设置

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

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

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

setup 流程：

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

日常管理

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

更新 key

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

重新部署

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

发布到 PyPI

# 安装构建工具
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

Metadata

Release files for gogeo-client-agentos 0.2.17

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for gogeo-client-agentos 0.2.17
File	Size	Uploaded	Provenance
gogeo_client_agentos-0.2.17.tar.gz	29.9 MB	May 13, 2026	Without provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for gogeo-client-agentos 0.2.17
File	Interpreter	ABI	Platform	Reset
gogeo_client_agentos-0.2.17-py3-none-any.whl 29.9 MB May 13, 2026 Without provenance	Python 3	none	any	Details

Total release size: 59.8 MB

Release files / gogeo_client_agentos-0.2.17.tar.gz

Download URL	gogeo_client_agentos-0.2.17.tar.gz
Size	29.9 MB
Tags	Source
SHA-256 checksum How to use checksums	`9f6e52351ab96efb18146048d050fd7b6c1601b0b873a93ce7db7d89692aef5e`
BLAKE2b-256 checksum How to use checksums	`5fd284742dfc6d6efe43f69979451c55c1e2e8eb324d46b377fb9edcd011f82b`
Upload date	May 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.13.2`

Release files / gogeo_client_agentos-0.2.17-py3-none-any.whl

Download URL	gogeo_client_agentos-0.2.17-py3-none-any.whl
Size	29.9 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`e4f95aa98a7a2c32fb10aec4edde136e06e9edf44c0321e5870d26b53141d83a`
BLAKE2b-256 checksum How to use checksums	`399c679f16ee514be468e6ed8171ea2b2b59b8c7a2c8e334d8d031147d2370d6`
Upload date	May 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.13.2`

Security for gogeo-client-agentos 0.2.17

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.