Metadata-Version: 2.4
Name: agnify
Version: 0.1.1
Summary: Command-line client for Agnify — drive video-analysis pipelines, uploads, executions, cameras, and events from your terminal.
Project-URL: Homepage, https://app.agnify.ai
Project-URL: Documentation, https://app.agnify.ai/docs/cli
Project-URL: Repository, https://github.com/agnifyai/agnify
Project-URL: Issues, https://github.com/agnifyai/agnify/issues
Author-email: Agnify <support@agnify.ai>
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: agnify,cli,computer-vision,inference,pipeline,video
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Multimedia :: Video
Classifier: Topic :: Utilities
Requires-Python: >=3.11
Requires-Dist: httpx>=0.26.0
Requires-Dist: pydantic>=2.5.0
Requires-Dist: pyjwt>=2.8.0
Requires-Dist: rich>=13.0.0
Requires-Dist: typer>=0.12.0
Provides-Extra: keyring
Requires-Dist: keyring>=24.0.0; extra == 'keyring'
Description-Content-Type: text/markdown

# Agnify CLI

`agnify` is the command-line client for [Agnify](https://app.agnify.ai), a
video-analysis platform. Drive pipelines, upload media, run executions, manage
cameras, and query events — all from your terminal.

## Install

One line (installs [uv](https://docs.astral.sh/uv/) if needed, then the CLI):

```sh
curl -LsSf https://app.agnify.ai/install.sh | sh
```

Or, if you already have a Python toolchain:

```sh
uv tool install 'agnify[keyring]'   # recommended — OS keychain for tokens
# or
pipx install 'agnify[keyring]'
# or
pip install 'agnify[keyring]'
```

The `[keyring]` extra stores your refresh token in the OS keychain (macOS
Keychain, Secret Service, Windows Credential Manager). Plain `agnify` also
works — it falls back to a `0600` file under `~/.config/agnify/`.

## Authenticate

```sh
agnify login        # device-code flow in your browser
agnify whoami       # confirm the active user + org
```

For CI / cron / integrations, skip `login` and set an org-scoped API key:

```sh
export AGNIFY_API_KEY=ak_…          # minted in the Agnify dashboard
export AGNIFY_API_BASE=https://app.agnify.ai
```

Self-hosted? Point the CLI at your backend with `AGNIFY_API_BASE`.

## Use

```sh
agnify nodes list                   # the pipeline node menu
agnify ingest file ./clip.mp4 --wait    # upload + run + wait for results
agnify run ls                       # list executions
agnify events tail                  # stream live pipeline events
```

Full command reference: <https://app.agnify.ai/docs/cli>

## License

[Apache-2.0](./LICENSE) © 2026 Fewbits Inc. (Agnify).
