Amon Hen

"From the Seat of Seeing, no moment remains hidden."

A fast, lightweight CLI and Python library for natural language video moment retrieval on local CPU. Runs entirely on CPU without discrete GPUs, background daemons, or cloud dependencies.

PyPI Python 3.11+ License: MIT

Key Highlights

  • 100% CPU Execution: Powered by Apple's MobileCLIP2 architecture and ONNX Runtime.
  • Low Footprint: Hybrid FP32-vision + INT8-quantized text pipeline (approx. 105 MB RAM).
  • Zero Infrastructure: Embedded vector database via SQLite and sqlite-vec (single .db file).
  • High Throughput: 3-gate adaptive motion sampler achieving 4.8x to 18.5x realtime indexing speed.
  • Temporal Grouping: Merges consecutive matching frames into start-end timestamp intervals.

Installation

# Recommended via uv
uv tool install amon-hen

# Or via pipx
pipx install amon-hen

# Or standard pip
pip install amon-hen

Quickstart

1. Interactive Terminal UI

Run amon-hen without arguments to launch the interactive prompt:

amon-hen

2. Index Videos

# Index a video or entire folder with adaptive motion sampling
amon-hen index /path/to/videos/ --sampler adaptive

3. Search Moments

# Search using natural language
amon-hen search "a person holding an umbrella"

4. Extract Video Clip

# Extract matching segment into a standalone video clip
amon-hen cut video.mp4 --start 00:00:37 --end 00:01:06 -o match.mp4

Python API

from amonhen.store import Store
from amonhen.model_registry import get_model
from amonhen.encode import TextEncoder
from amonhen.pipeline import search

# 1. Connect to index
store = Store("index.db", embed_dim=512)

# 2. Load CPU-optimized text encoder
model = get_model("mobileclip2-s0").download()
text_encoder = TextEncoder(model.text_model_path, model.tokenizer_path)

# 3. Retrieve matching video segments
results = search("red sports car turning", store=store, text_encoder=text_encoder)
for seg in results:
    print(
        f"{seg.video_path}: {seg.start_ms / 1000.0:.1f}s - {seg.end_ms / 1000.0:.1f}s (score: {seg.score:.3f})"
    )

Resources & Links

Project links

Data verified by PyPI on Aug 30, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.1.21)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for flxhrdyn from gravatar.com flxhrdyn

Credits

Author: Felix Hardyan

GitHub Statistics

Data verified by PyPI on Aug 30, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT)

Requires

Python >=3.11

Tags

cli clip computer-vision mobileclip multimodal onnx onnxruntime semantic-search sqlite-vec video-retrieval video-search

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

amon_hen-0.1.2.tar.gz (6.8 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

amon_hen-0.1.2-py3-none-any.whl (29.2 kB view details)

Uploaded Python 3

File details

Details for the file amon_hen-0.1.2.tar.gz.

File metadata

  • Download URL: amon_hen-0.1.2.tar.gz
  • Upload date:
  • Size: 6.8 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for amon_hen-0.1.2.tar.gz
Algorithm Hash digest
SHA256 0c11dc4659b6bb3affae0fad7ea957f0c1c6f230dfc951a87076c18bb7c4d4ee
MD5 f4c5f9338158d8506f223527f49d4bd2
BLAKE2b-256 5168049d499d4a2493f1dd48eff1e1248ee62e77f7917cc0d3ded39dfdc99659

See more details on using hashes here.

Provenance

The following attestation bundles were made for amon_hen-0.1.2.tar.gz:

Publisher: release.yml on flxhrdyn/amon-hen

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file amon_hen-0.1.2-py3-none-any.whl.

File metadata

  • Download URL: amon_hen-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 29.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for amon_hen-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 f9f89096d1f24e605a3536bcbb3acb04cec338c625c31b082ac58ca6e25197e7
MD5 97f2755cdc8d3d43772aea06f4a5f50d
BLAKE2b-256 b42dec9596b479507588bc63497fccd042fb9ae5b4ebf29cb609d7f768f71ad6

See more details on using hashes here.

Provenance

The following attestation bundles were made for amon_hen-0.1.2-py3-none-any.whl:

Publisher: release.yml on flxhrdyn/amon-hen

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.1.21

2 files

0.1.20

2 files

0.1.19

2 files

0.1.18

2 files

0.1.17

2 files

0.1.16

2 files

0.1.15

2 files

0.1.14

2 files

0.1.13

2 files

0.1.12

2 files

0.1.11

2 files

0.1.10

2 files

0.1.9

2 files

0.1.8

2 files

0.1.7

2 files

0.1.6

2 files

0.1.5

2 files

0.1.4

2 files

0.1.3

2 files

This release

0.1.2 This release

2 files

0.1.1

2 files

0.1.0

2 files

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