Metadata-Version: 2.5
Name: envloop-cli
Version: 0.2.0
Summary: EnvLoop CLI and Python SDK for jobs, training, checkpoints and inference
Project-URL: Homepage, https://envloop.ai
Project-URL: Documentation, https://docs.envloop.ai
Project-URL: Agent instructions, https://docs.envloop.ai/skill.md
Requires-Python: >=3.11
Provides-Extra: train
Requires-Dist: tinker==0.30.2; extra == 'train'
Description-Content-Type: text/markdown

# EnvLoop CLI and Python SDK

Install the public client to run agent Jobs, inspect Trials, manage training and
checkpoints, and deploy or call inference endpoints. The `el` and `envloop`
commands are equivalent. The Python import package is `envloop`.

## Install

Use a Python virtual environment:

```bash
python -m pip install envloop-cli
el --help
```

For Python training workflows, install the optional training dependency:

```bash
python -m pip install 'envloop-cli[train]'
python -c 'from envloop import Client, training; print("EnvLoop SDK ready")'
```

The base client uses Python's standard library. The training extra installs the
training protocol client. You do not need a source checkout, GitHub account,
local execution backend, Docker, or a GPU to install the client.

## Connect

Use an authorized EnvLoop account and project. Browser authorization:

```bash
el auth login
el auth status --check
```

For an existing project API key, use the masked configuration wizard:

```bash
el auth config
el auth status --check
```

CI can read credentials from `ENVLOOP_API_KEY` and connection settings from
`ENVLOOP_BASE_URL`, `ENVLOOP_WORKSPACE_ID` and `ENVLOOP_PROJECT_ID`. Keep keys in
your secret manager. Public API access is scoped to the authorized project.

## Explore your project

```bash
el job list --limit 5
el train list --limit 5
el checkpoint list --limit 5
el inference endpoint list
```

Query a returned Job ID with `el job get JOB_ID` and `el job result JOB_ID`.
Trial commands use the spelling `trail`, for example
`el trail artifact list TRIAL_ID`. Use each command's `--help` for options.

For the Python SDK:

```python
from envloop import Client

with Client.remote() as client:
    print(client.jobs.list(limit=5))
```

Submitting work, training a model or starting inference can allocate billable
resources. Follow the task-specific guide and retain the outputs you need before
cleaning up temporary resources.

## Existing installations

This distribution provides both the CLI and the `envloop` import package. Use a
fresh environment if you previously installed the separate source distribution
named `envloop`, so two distributions do not own the same Python module files.
Existing client configuration is reused; installing a package does not change
your account permissions or move remote resources. Check `el --help` when
upgrading because command groups may differ from your earlier installation.

## Documentation

- [English documentation](https://docs.envloop.ai/)
- [中文文档](https://docs.envloop.ai/zh-cn/)
- [Installation](https://docs.envloop.ai/cli-install)
- [CLI reference](https://docs.envloop.ai/reference/cli)
- [Training and deployment](https://docs.envloop.ai/training/train-deploy)
- [Agent entry: skill.md](https://docs.envloop.ai/skill.md)
