computenexa 0.1.1__tar.gz

computenexa-0.1.1/.github/workflows/publish.yml

@@ -0,0 +1,21 @@
+# Publishes to PyPI when a GitHub release is published (tag v<version>, matching pyproject.toml).
+# Uses PyPI trusted publishing: no password or token is stored anywhere. One-time setup on pypi.org
+# (account support@computenexa.com): add a trusted publisher for this repo, workflow publish.yml, environment pypi.
+name: publish
+on:
+  release:
+    types: [published]
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - name: The tag matches the package version
+        run: test "${GITHUB_REF_NAME#v}" = "$(grep -m1 '^version' pyproject.toml | cut -d'"' -f2)"
+      - run: uv sync && uv run pytest -q
+      - run: uv build
+      - uses: pypa/gh-action-pypi-publish@release/v1

computenexa-0.1.1/.github/workflows/test.yml

@@ -0,0 +1,17 @@
+name: test
+on:
+  push:
+    branches: [main]
+  pull_request:
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - run: uv sync --python ${{ matrix.python }}
+      - run: uv run ruff check src tests
+      - run: uv run pytest -q

computenexa-0.1.1/.gitignore

@@ -0,0 +1,7 @@
+__pycache__/
+*.egg-info/
+.venv/
+dist/
+build/
+.pytest_cache/
+.ruff_cache/

computenexa-0.1.1/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## 0.1.1
+
+First release on PyPI (0.1.0 was never uploaded: PyPI refused its support link). Same code as 0.1.0.
+
+## 0.1.0
+
+First release: account and balance, catalog (GPUs, apps, recommended models, image contents), launch / get / list /
+extend / stop, `with client.gpu(...)` that always stops the GPU, projects, SSH keys, ledger; one exception per kind
+of refusal; reads retried on 429 and 5xx, launches never sent twice.

computenexa-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ComputeNexa
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

computenexa-0.1.1/PKG-INFO

@@ -0,0 +1,155 @@
+Metadata-Version: 2.5
+Name: computenexa
+Version: 0.1.1
+Summary: Python client for ComputeNexa: private GPUs for your business, launched and stopped from code.
+Project-URL: Homepage, https://computenexa.com
+Project-URL: Documentation, https://app.computenexa.com/help/api
+Project-URL: API reference, https://app.computenexa.com/help/api/reference
+Project-URL: Support, https://app.computenexa.com/help
+Author-email: ComputeNexa <support@computenexa.com>
+Maintainer-email: ComputeNexa <support@computenexa.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,cloud,computenexa,gpu,inference,llm,private ai,training
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Requires-Dist: httpx<1,>=0.27
+Description-Content-Type: text/markdown
+
+# ComputeNexa Python SDK
+
+Launch, use and stop private GPUs on [ComputeNexa](https://computenexa.com) from Python. Each GPU is reserved for
+your team, runs open AI models or your own code, and is paid by the minute from your team's prepaid credits.
+
+```bash
+pip install computenexa
+```
+
+## Quick start
+
+Create an API key in the dashboard under **API keys** ("Launch and stop" to launch), then:
+
+```bash
+export CNX_API_KEY="cnxk_..."
+```
+
+```python
+from computenexa import Client
+
+cnx = Client()                                    # reads CNX_API_KEY
+
+# Launch an RTX 4090 with JupyterLab and PyTorch for 2 hours; it's stopped when the block ends,
+# even if your code fails, and unused minutes are refunded.
+with cnx.gpu("rtx-4090", app="datascience", hours=2) as machine:
+    print(machine.ssh_command)                    # ssh cnx-7f3a9c@ssh.computenexa.com
+    ...                                           # your work
+```
+
+## Choose a GPU and an app
+
+```python
+catalog = cnx.catalog()                           # live prices and stock; catalog.apps describes each app
+for gpu in catalog.available(app="chat"):         # for sale now, cheapest first
+    print(gpu.slug, gpu.vram_gb, "GB", gpu.price_per_hour_cents / 100, "$/h")
+
+chat = catalog.apps["chat"]
+print(chat.recommended_model(vram_gb=48))         # our model pick for a 48 GB GPU
+print(cnx.image_contents("datascience"))          # every package and version installed
+```
+
+| `app=` | On the launch page | For |
+|---|---|---|
+| `chat` | Private Chat | chat with open AI models about your documents, in your browser |
+| `imagegen` | Image Generation (ComfyUI) | images with SDXL or FLUX |
+| `modelapi` | Model API (vLLM) | an AI model behind your own API key |
+| `voice` | Voice Agent | speech in, spoken AI reply out |
+| `datascience` | Notebook (Jupyter) | JupyterLab, PyTorch, pandas: analysis, training, fine-tuning |
+| `basic` | Basic (SSH only) | Ubuntu + CUDA for your own code |
+
+## Keep files between sessions with projects
+
+A project is saved storage: launched with it, a GPU starts with the project's files in `~/work` and saves
+`~/work` back automatically.
+
+```python
+project = cnx.get_or_create_project("titanic-training")
+machine = cnx.launch("l40s", app="datascience", hours=4, project=project, label="nightly training")
+machine.wait_until_running(on_progress=lambda m: print(m.state, m.startup_progress or ""))
+print(machine.ssh_command)
+# ... later
+machine.stop()
+print("refunded", machine.refunded_cents / 100)
+```
+
+## Machines
+
+```python
+cnx.list_instances(active=True)                   # your running and starting machines
+cnx.list_instances(everyone=True)                 # the whole team's (owners and admins)
+machine = cnx.get_instance("cnx-7f3a9c")
+machine.extend(hours=1)                           # same price it launched with
+machine.stop()                                    # stops if running, cancels if still starting
+```
+
+## Account, credits and SSH keys
+
+```python
+me = cnx.account()
+print(me.email, me.organization.name, me.organization.role, me.balance, me.max_concurrent_gpus)
+for entry in cnx.ledger(limit=20):
+    print(entry.created_at, entry.description, entry.amount_cents / 100)
+
+cnx.add_ssh_key("Work laptop", open("/Users/me/.ssh/id_ed25519.pub").read())   # the PUBLIC key only
+```
+
+## Errors
+
+Every refusal raises a subclass of `computenexa.ComputeNexaError` with a stable `code`, a `message` you can show
+and a `request_id` to quote to support:
+
+| Exception | When |
+|---|---|
+| `InsufficientCreditsError` | not enough credits for the launch or extension |
+| `NoCapacityError` | that GPU is fully booked right now: retry or pick another |
+| `GpuLimitReachedError` | your team (or you) already run as many GPUs as allowed |
+| `ProjectInUseError` | another GPU is using the project |
+| `AuthenticationError` | the key is missing, mistyped or revoked |
+| `PermissionDeniedError` | a look-only key tried to launch, or a dashboard-only setting |
+| `NotFoundError` | no such machine or project, or not one you can see |
+| `LaunchFailedError` | the machine couldn't start (refunded in full) |
+| `WaitTimeoutError` | `wait_until_running` gave up; the machine may still start |
+
+```python
+from computenexa import NoCapacityError
+
+for gpu in ["rtx-4090", "l40s", "a40"]:
+    try:
+        machine = cnx.launch(gpu, app="chat", hours=1)
+        break
+    except NoCapacityError:
+        continue
+```
+
+Reads are retried automatically when the API is busy (429) or has a server error. A launch is never retried after
+an uncertain failure, so it can't start two GPUs.
+
+## Configuration
+
+| | |
+|---|---|
+| `Client(api_key=...)` or `CNX_API_KEY` | your API key |
+| `Client(base_url=...)` or `CNX_API_URL` | defaults to `https://api.computenexa.com/v1` |
+| `Client(timeout=30, max_retries=3)` | per request |
+
+## Help
+
+- Guide: <https://app.computenexa.com/help/api>
+- Every operation: <https://app.computenexa.com/help/api/reference>
+- Support: <support@computenexa.com>
+
+MIT licensed. © ComputeNexa.

computenexa-0.1.1/README.md

@@ -0,0 +1,132 @@
+# ComputeNexa Python SDK
+
+Launch, use and stop private GPUs on [ComputeNexa](https://computenexa.com) from Python. Each GPU is reserved for
+your team, runs open AI models or your own code, and is paid by the minute from your team's prepaid credits.
+
+```bash
+pip install computenexa
+```
+
+## Quick start
+
+Create an API key in the dashboard under **API keys** ("Launch and stop" to launch), then:
+
+```bash
+export CNX_API_KEY="cnxk_..."
+```
+
+```python
+from computenexa import Client
+
+cnx = Client()                                    # reads CNX_API_KEY
+
+# Launch an RTX 4090 with JupyterLab and PyTorch for 2 hours; it's stopped when the block ends,
+# even if your code fails, and unused minutes are refunded.
+with cnx.gpu("rtx-4090", app="datascience", hours=2) as machine:
+    print(machine.ssh_command)                    # ssh cnx-7f3a9c@ssh.computenexa.com
+    ...                                           # your work
+```
+
+## Choose a GPU and an app
+
+```python
+catalog = cnx.catalog()                           # live prices and stock; catalog.apps describes each app
+for gpu in catalog.available(app="chat"):         # for sale now, cheapest first
+    print(gpu.slug, gpu.vram_gb, "GB", gpu.price_per_hour_cents / 100, "$/h")
+
+chat = catalog.apps["chat"]
+print(chat.recommended_model(vram_gb=48))         # our model pick for a 48 GB GPU
+print(cnx.image_contents("datascience"))          # every package and version installed
+```
+
+| `app=` | On the launch page | For |
+|---|---|---|
+| `chat` | Private Chat | chat with open AI models about your documents, in your browser |
+| `imagegen` | Image Generation (ComfyUI) | images with SDXL or FLUX |
+| `modelapi` | Model API (vLLM) | an AI model behind your own API key |
+| `voice` | Voice Agent | speech in, spoken AI reply out |
+| `datascience` | Notebook (Jupyter) | JupyterLab, PyTorch, pandas: analysis, training, fine-tuning |
+| `basic` | Basic (SSH only) | Ubuntu + CUDA for your own code |
+
+## Keep files between sessions with projects
+
+A project is saved storage: launched with it, a GPU starts with the project's files in `~/work` and saves
+`~/work` back automatically.
+
+```python
+project = cnx.get_or_create_project("titanic-training")
+machine = cnx.launch("l40s", app="datascience", hours=4, project=project, label="nightly training")
+machine.wait_until_running(on_progress=lambda m: print(m.state, m.startup_progress or ""))
+print(machine.ssh_command)
+# ... later
+machine.stop()
+print("refunded", machine.refunded_cents / 100)
+```
+
+## Machines
+
+```python
+cnx.list_instances(active=True)                   # your running and starting machines
+cnx.list_instances(everyone=True)                 # the whole team's (owners and admins)
+machine = cnx.get_instance("cnx-7f3a9c")
+machine.extend(hours=1)                           # same price it launched with
+machine.stop()                                    # stops if running, cancels if still starting
+```
+
+## Account, credits and SSH keys
+
+```python
+me = cnx.account()
+print(me.email, me.organization.name, me.organization.role, me.balance, me.max_concurrent_gpus)
+for entry in cnx.ledger(limit=20):
+    print(entry.created_at, entry.description, entry.amount_cents / 100)
+
+cnx.add_ssh_key("Work laptop", open("/Users/me/.ssh/id_ed25519.pub").read())   # the PUBLIC key only
+```
+
+## Errors
+
+Every refusal raises a subclass of `computenexa.ComputeNexaError` with a stable `code`, a `message` you can show
+and a `request_id` to quote to support:
+
+| Exception | When |
+|---|---|
+| `InsufficientCreditsError` | not enough credits for the launch or extension |
+| `NoCapacityError` | that GPU is fully booked right now: retry or pick another |
+| `GpuLimitReachedError` | your team (or you) already run as many GPUs as allowed |
+| `ProjectInUseError` | another GPU is using the project |
+| `AuthenticationError` | the key is missing, mistyped or revoked |
+| `PermissionDeniedError` | a look-only key tried to launch, or a dashboard-only setting |
+| `NotFoundError` | no such machine or project, or not one you can see |
+| `LaunchFailedError` | the machine couldn't start (refunded in full) |
+| `WaitTimeoutError` | `wait_until_running` gave up; the machine may still start |
+
+```python
+from computenexa import NoCapacityError
+
+for gpu in ["rtx-4090", "l40s", "a40"]:
+    try:
+        machine = cnx.launch(gpu, app="chat", hours=1)
+        break
+    except NoCapacityError:
+        continue
+```
+
+Reads are retried automatically when the API is busy (429) or has a server error. A launch is never retried after
+an uncertain failure, so it can't start two GPUs.
+
+## Configuration
+
+| | |
+|---|---|
+| `Client(api_key=...)` or `CNX_API_KEY` | your API key |
+| `Client(base_url=...)` or `CNX_API_URL` | defaults to `https://api.computenexa.com/v1` |
+| `Client(timeout=30, max_retries=3)` | per request |
+
+## Help
+
+- Guide: <https://app.computenexa.com/help/api>
+- Every operation: <https://app.computenexa.com/help/api/reference>
+- Support: <support@computenexa.com>
+
+MIT licensed. © ComputeNexa.

computenexa-0.1.1/pyproject.toml

@@ -0,0 +1,44 @@
+[project]
+name = "computenexa"
+version = "0.1.1"
+description = "Python client for ComputeNexa: private GPUs for your business, launched and stopped from code."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "ComputeNexa", email = "support@computenexa.com" }]
+maintainers = [{ name = "ComputeNexa", email = "support@computenexa.com" }]
+requires-python = ">=3.9"
+dependencies = ["httpx>=0.27,<1"]
+keywords = ["gpu", "cloud", "ai", "private ai", "computenexa", "llm", "inference", "training"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Topic :: Scientific/Engineering :: Artificial Intelligence",
+  "Typing :: Typed",
+]
+
+[project.urls]
+Homepage = "https://computenexa.com"
+Documentation = "https://app.computenexa.com/help/api"
+"API reference" = "https://app.computenexa.com/help/api/reference"
+Support = "https://app.computenexa.com/help"
+
+[build-system]
+requires = ["hatchling>=1.26"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/computenexa"]
+
+[dependency-groups]
+dev = ["pytest>=8", "ruff>=0.6"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+markers = ["integration: talks to a real ComputeNexa API (set CNX_TEST_API_URL and CNX_TEST_API_KEY)"]
+
+[tool.ruff]
+line-length = 120
+target-version = "py39"

computenexa-0.1.1/src/computenexa/__init__.py

@@ -0,0 +1,60 @@
+"""ComputeNexa: private GPUs for your business, from Python.
+
+    from computenexa import Client
+
+    cnx = Client()                                    # reads CNX_API_KEY
+    with cnx.gpu("rtx-4090", app="datascience", hours=2) as machine:
+        print(machine.ssh_command)
+
+Guide: https://app.computenexa.com/help/api · Reference: https://app.computenexa.com/help/api/reference
+"""
+
+__version__ = "0.1.1"
+
+from .client import Client
+from .errors import (
+    APIConnectionError,
+    AuthenticationError,
+    ComputeNexaError,
+    ConflictError,
+    GpuLimitReachedError,
+    InsufficientCreditsError,
+    InvalidRequestError,
+    LaunchFailedError,
+    NoCapacityError,
+    NotFoundError,
+    PermissionDeniedError,
+    ProjectInUseError,
+    RateLimitError,
+    ServerError,
+    WaitTimeoutError,
+)
+from .models import Account, App, Catalog, Gpu, Instance, LedgerEntry, Organization, Project, SshKey
+
+__all__ = [
+    "APIConnectionError",
+    "Account",
+    "App",
+    "AuthenticationError",
+    "Catalog",
+    "Client",
+    "ComputeNexaError",
+    "ConflictError",
+    "Gpu",
+    "GpuLimitReachedError",
+    "Instance",
+    "InsufficientCreditsError",
+    "InvalidRequestError",
+    "LaunchFailedError",
+    "LedgerEntry",
+    "NoCapacityError",
+    "NotFoundError",
+    "Organization",
+    "PermissionDeniedError",
+    "Project",
+    "ProjectInUseError",
+    "RateLimitError",
+    "ServerError",
+    "SshKey",
+    "WaitTimeoutError",
+]