Metadata-Version: 2.4
Name: naas
Version: 3.0.0a0
Summary: naas.ai wallet: FastAPI ledger plus CLI (wallet, checkout, credits)
Author-email: "NaasAI, Inc" <hello@naas.ai>
License: BSD-3-Clause
Project-URL: Homepage, https://github.com/jupyter-naas/naas
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: fastapi>=0.110
Requires-Dist: httpx>=0.27
Requires-Dist: uvicorn>=0.27

# naas

Terminal CLI and wallet API for naas.ai. After `pip install naas`, run `naas` from your shell, the same way you run `gh` or `gcloud`. Do not type `import naas` in zsh; that only works inside Python.

```bash
pip install naas
naas ui
naas wallet
naas credits
naas checkout 10
```

`naas wallet` saves the key to `~/.naas/credentials`. `naas signup` is an alias.

**Terminal:** `naas …` (the `naas` binary on PATH).

**Python** (REPL, notebook, or script only):

```python
import naas
naas.ui()
```

Same as `naas ui`. `naas.web()` is an alias.

## Hosts

- API: `https://api.console.naas.ai` (override: `NAAS_API_BASE`)
- Console: `https://console.naas.ai` (override: `NAAS_CONSOLE_URL`)
- Local: `naas serve`, then open `http://127.0.0.1:9879/`

## Drivers

```bash
pip install naas-drivers
naas-drivers fetch iss
```

Drivers read `~/.naas/credentials`, or `NAAS_API_KEY`, or `api_key=`.

## Run the API locally

```bash
naas serve
```

Console at `/`. Swagger at `/docs`.
