vibecloud

SDK Python chính thức, zero-dependency, cho VibeCloud. Client đồng bộ dùng urllib trong standard library, chạy trên Python 3.9+, nhận token vc_live_* hoặc access token MONA Pass qua Bearer.

VibeCloud được phát triển từ kinh nghiệm EAV qua 14.000+ dự án của MONA.

Cài đặt

pip install vibecloud

Deploy app và đợi job

Ví dụ 10 dòng dưới đây chạy thử sandbox 0đ trước, sau đó tạo VPS thật:

import os
from vibecloud import VibeCloud
token = os.environ["VIBECLOUD_TOKEN"]
sandbox = VibeCloud(token=token, sandbox=True)
preview = sandbox.create_vps({"app_name": "demo-app", "package_slug": "standard-1"})
print("sandbox:", sandbox.wait_job(preview["id"], timeout=60)["result"])
cloud = VibeCloud(token=token)
job = cloud.create_vps({"app_name": "demo-app", "package_slug": "standard-1"})
done = cloud.wait_job(job["id"], timeout=600)
print("production:", done["result"])

create_vps() và create_database() tự tạo header Idempotency-Key. Truyền idempotency_key="deploy-order-123" để retry với key ổn định. Các alias camelCase (createVps, waitJob, ...) cũng có sẵn để agent dùng cùng tên trên ba SDK.

Public API

• prices(), packages(), me()
• create_vps(payload), create_database(payload)
• job(id), wait_job(id, timeout=300, poll_interval=1)
• services(), start_service(id), stop_service(id), rebuild_service(id), delete_service(id)

Lỗi

Mọi lỗi API là VibeCloudError với code, message, next_step, status và body.

Xem hướng dẫn dành cho AI agent.

Test

python -m unittest