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.17.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.17.0
File Size Uploaded Provenance
agnify-0.17.0.tar.gz 106.8 kB With provenance Details

Built distribution (wheel)

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

Total release size: 188.4 kB

Release files / agnify-0.17.0.tar.gz

Download URL agnify-0.17.0.tar.gz
Size 106.8 kB
Tags Source
SHA-256 checksum
How to use checksums
3e0e1d8b4e9cac53e63ed15baf12a0f1dcb7a16cf213470c71b172b532a4b9f6
BLAKE2b-256 checksum
How to use checksums
08a1d8dd2c9e1331f0bcc9a5d4b47693aa56f2c6c94592835971b313d211d0b2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 22, 2026.

Transparency log

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

Download URL agnify-0.17.0-py3-none-any.whl
Size 81.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
83353627625936a63e756d6d050daa72774f252a7af6bf62b7355c3a7227772f
BLAKE2b-256 checksum
How to use checksums
9719c755abb0ea67c963d65d37307ba295cedd539c99a5f7c7e6108cfbf6b891
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 22, 2026.

Transparency log

Security for agnify 0.17.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.17.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 22, 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