Skip to main content

Agnify CLI

agnify is the command-line client for Agnify, a video-analysis platform. Drive pipelines, upload media, run executions, manage cameras, and query events — all from your terminal.

Install

One line (installs uv if needed, then the CLI):

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

Or, if you already have a Python toolchain:

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

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:

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

agnify nodes list                   # the pipeline node menu
agnify ingest file ./clip.mp4 --pipeline <template> --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

To import historical footage into a camera, supply its original start time explicitly, including Z or a UTC offset:

agnify camera stream cam-EXAMPLE --source ./footage.mp4 \
  --recorded-at 2026-08-01T09:00:00Z

Each segment is timestamped at that start time plus its actual position in the video. This option requires a local video file; it does not read recording dates from video metadata. Without it, streaming uses the current wall clock.

License

Apache-2.0 © 2026 Fewbits Inc. (Agnify).

Metadata

Release files for agnify 0.16.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for agnify 0.16.0
File Size Uploaded Provenance
agnify-0.16.0.tar.gz 106.4 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for agnify 0.16.0
File Interpreter ABI Platform
agnify-0.16.0-py3-none-any.whl Python 3 none any Details

Total release size: 187.8 kB

Release files / agnify-0.16.0.tar.gz

Download URL agnify-0.16.0.tar.gz
Size 106.4 kB
Tags Source
SHA-256 checksum
How to use checksums
de94bbeab3634326ad7411e938816dc2fc321edebf3234bfd448b9973b25ad08
BLAKE2b-256 checksum
How to use checksums
ee44a972c5219ba3de9693d0718e2409c53503f91a873434d7d7c4b34a5bfecf
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 19, 2026.

Transparency log

Release files / agnify-0.16.0-py3-none-any.whl

Download URL agnify-0.16.0-py3-none-any.whl
Size 81.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3eeb5985017ee053f3f500b8780d677c03e85a45675f45e1d57f51821edfba51
BLAKE2b-256 checksum
How to use checksums
7497ce3e6292155cdea3b07b1d56bbec611e3820329313ee5bb382fa5c98dc96
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 19, 2026.

Transparency log

Security for agnify 0.16.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for agnify-0.16.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 19, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page