Metadata-Version: 2.4
Name: nestor-cloud
Version: 0.1.3
Summary: Python SDK and `nestor` CLI for Nestor Cloud, infrastructure for AI applications.
Author: Nestor Cloud engineering
License: Proprietary
Project-URL: Documentation, https://docs.nestor.software/sdks/python
Project-URL: Homepage, https://nestor.software
Keywords: nestor,inference,ai,infrastructure,sdk,cli
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# Nestor Cloud Python SDK and CLI

`nestor-cloud` is Nestor's Python SDK and CLI. The Python import and executable
are both `nestor`. It supports Python 3.10 through 3.14 and has no third-party
runtime dependencies.

## Install

Install from public PyPI in a virtual environment:

```sh
python3 -m venv .venv
. .venv/bin/activate
python -m pip install nestor-cloud
```

[Nestor's installation guide](https://docs.nestor.software/cli) includes Windows
activation, release verification, the minimum Compute version and credential setup.

After installing in a virtual environment:

```sh
nestor --version
nestor --help
python -c "from nestor import Nestor; print('Nestor import OK')"
export NESTOR_API_URL=https://api.nestor.software
export NESTOR_ORGANIZATION=YOUR_ORGANIZATION_ID
export NESTOR_PROJECT=YOUR_PROJECT_ID
# Bash or zsh: paste the management key at the hidden prompt.
read -r -s NESTOR_API_KEY
export NESTOR_API_KEY
nestor inference endpoints list
nestor data list
```

Get scope IDs from Console Settings and a Service Account management key from
Console Access. Use the full one-time secret; a public key ID or prefix is not a
bearer credential. Project discovery may return 403 for a project-scoped key;
use the scope IDs from Settings. `nestor auth login` stores an existing bearer;
it is not browser sign-in. Inject credentials from your secret manager in CI.

## Use Python

```python
from nestor import Nestor

client = Nestor()
for endpoint in client.inference.endpoints.list():
    print(endpoint.id, endpoint.state)
for item in client.data.list():
    print(item.id, item.state)
```

A management key cannot invoke an Endpoint. A signed-in human issues a separate
Endpoint-bound invocation key in Console Access. Load it privately as
`NESTOR_INFERENCE_KEY`, then call an existing chat Endpoint:

```python
import os

endpoint = client.inference.endpoints.get(os.environ["NESTOR_ENDPOINT_ID"])
reply = client.inference.endpoints.chat(
    endpoint, "Hello!", max_tokens=16,
    key=os.environ["NESTOR_INFERENCE_KEY"],
)
print(reply.text)
```

Missing, expired or revoked management credentials return CLI exit 3. Obtain a
replacement through Console Access. Revoking keys does not stop running work.

## Guides

- [Get started](https://docs.nestor.software/)
- [Python SDK](https://docs.nestor.software/sdks/python)
- [Compute and customer SSH](https://docs.nestor.software/compute)
- [Compute billing and termination terms](https://docs.nestor.software/compute/billing)
- [CLI](https://docs.nestor.software/cli)
- [Training and Run](https://docs.nestor.software/training/runs)
- [Checkpoints and LoRA](https://docs.nestor.software/guides/fine-tune)

`nestor training runs --help`, `nestor run --help`, and
`nestor runs checkpoints --help` describe the available commands.
`from nestor import Client` and `nestor train` remain supported aliases.

`nestor compute --help` covers the catalog, access and dedicated Instance commands.
The Python surface is `Nestor().compute`: catalog/access plus `compute.instances`.
Paid creation requires the reviewed catalog `price_id`, `terms_ref` and your SSH
public key. Existing authentication, pagination, Operations and retry behavior apply.
