Provision multi-cloud infrastructure, deploy apps, run governed AI agents, and drive the node control plane — from your code or CI.

npm PyPI Go Reference License

🌐 Website · 📚 Docs · 💻 CLI · 🐳 vxnode image · ⚙️ node tooling

Install

npm install @vxcloud/sdk
# pnpm add @vxcloud/sdk | yarn add @vxcloud/sdk

pip install vxsdk # sync client, stdlib-only
pip install "vxsdk[async]" # + async client (httpx)
# pip install vxcloud # identical, brand-name alias

go get github.com/prodxcloud/vxcloud@latest
# pin the preview tag:
go get github.com/prodxcloud/vxcloud@v0.1.0-preview

Quick start (30 seconds)

import { VxCloud } from '@vxcloud/sdk';
// from vxcli creds, or: new VxCloud({ apiKey: 'xc_live_...', username: 'alice' })
const c = await VxCloud.loadFromVxcli();
console.log(await c.cicd.pipelines.list());
console.log(await c.vxcomputer.run({ objective: 'Check disk usage', channel: 'cloudshell' }));

import vxsdk # or: import vxcloud
c = vxsdk.Client.load_from_vxcli() # or vxsdk.Client(api_key="xc_live_...", username="alice")
print(c.cicd.pipelines.list())
print(c.vxcomputer.run("Check disk usage", channel="cloudshell"))

package main
import (
 "context"
 "fmt"
 vxsdk "github.com/prodxcloud/vxcloud"
 "github.com/prodxcloud/vxcloud/vxcomputer"
)
func main() {
 ctx := context.Background()
 c, err := vxsdk.LoadFromVxcli(ctx) // or vxsdk.New(ctx, vxsdk.WithAPIKey("xc_live_..."))
 if err != nil { panic(err) }
 pipelines, _ := c.CICD().Pipelines().List(ctx)
 for _, p := range pipelines {
 fmt.Println(p.ID, p.Name, p.Repository)
 }
 res, _ := c.VxComputer().Run(ctx, vxcomputer.RunInput{
 Objective: "Check disk usage and report",
 Channel: "cloudshell",
 })
 fmt.Println(res["status"])
}

Authentication

const c = new VxCloud({ apiKey: 'xc_live_...', username: 'alice' }); // explicit

c = vxsdk.Client(api_key="xc_live_...", username="alice")

c, _ := vxsdk.New(ctx, vxsdk.WithAPIKey("xc_live_..."))

What you can do

A few real calls (Go)

// trigger a build
build, _ := c.CICD().Pipelines().Trigger(ctx, pipelineID, "main")
// deploy a Docker container over SSH
c.Deploy().Container(ctx, deploy.ContainerOpts{
 SSH: deploy.SSH{Host: ip, User: "ubuntu", KeyPairName: keyName},
 Image: "grafana/grafana:latest", Name: "grafana", Ports: []string{"3000:3000"},
})
// deploy a language stack from a git repo
c.Deploy().Stack(ctx, deploy.StackGolang, deploy.StackOpts{
 SSH: deploy.SSH{Host: ip, User: "ubuntu", KeyPairName: keyName},
 RepoURL: "https://github.com/youruser/yourapp.git", Branch: "main",
 AppName: "yourapp", HTTPPort: "80", GoVersion: "1.22",
})

Design contracts (stable across versions)

Releasing a new version (maintainers)

# Go — tagging IS the release (no registry)
git tag v0.2.0 && git push origin v0.2.0 # then: go get github.com/prodxcloud/vxcloud@v0.2.0
# TypeScript → npm
cd typescript && npm version 0.2.0 && npm publish --access public
# Python → PyPI (vxsdk first, then the vxcloud alias)
cd python && python -m build && twine upload dist/*
cd ../python-vxcloud && python -m build && twine upload dist/*

License