cerul-ai/cerul

cerul-ai 프로필

최근 기록된 소스 활동: 2026년 10월 8일 15:26

SkillsMP 카탈로그 업데이트: 2026년 10월 26일 11:37

수집된 skills: 2

GitHub 스타: 164
GitHub 포크: 9

저장소 README

README 원본 파일: README.md

README 원본 보기

README 전체 펼치기

<picture> <source media="(prefers-color-scheme: dark)" srcset="docs/assets/cerul-logo-dark.png"> <img src="docs/assets/cerul-logo-light.png" alt="Cerul" width="280"> </picture> Help AI understand, remember, and access video. Open-source video processing core and CLI. Use your own model endpoints, without a Cerul account. <a href="https://cerul.ai">Website</a> · <a href="docs/video-search.md">Quickstart</a> · <a href="docs/agent-setup.md">Install with an agent</a> · <a href="docs/configuration.md">Configuration</a> · <a href="https://x.com/cerul_hq">X / Twitter</a> · <a href="https://discord.gg/qHDEMQB9vN">Discord</a> <a href="https://github.com/cerul-ai/cerul/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/cerul-ai/cerul/ci.yml?branch=main&style=flat-square&logo=github&logoColor=white&label=build" alt="Build and tests"></a> <a href="https://github.com/cerul-ai/cerul/releases"><img src="https://img.shields.io/github/v/release/cerul-ai/cerul?style=flat-square&color=2160FA&label=release" alt="Latest release"></a> <img src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux-1D2229?style=flat-square" alt="Platforms: macOS and Linux"> <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-1D2229?style=flat-square" alt="License: Apache-2.0"></a> <a href="https://discord.gg/qHDEMQB9vN"><img src="https://img.shields.io/badge/Discord-join-5865F2?style=flat-square&logo=discord&logoColor=white" alt="Join the Discord"></a> English · <a href="README.zh-CN.md">简体中文</a> · <a href="README.zh-TW.md">繁體中文</a> ## Search your videos with words Cerul turns local videos into a searchable library. Describe a moment, find text spoken or shown on screen, and save matching clips. It works with ordinary video folders, using your own model API key. - **Search by meaning or example.** Use a sentence or a reference image. - **Find speech and screen text.** Transcription plus local, embedded OCR. - **Keep useful results.** Export clips and structured semantic annotations. - **Resume where you left off.** Completed work is cached; rerun after interruption. ## Getting started Cerul is a command-line tool for searching videos and saving clips. The download includes the media tools and OCR models it needs. Supports **macOS Apple Silicon** and **Linux x86_64 (Ubuntu 24.04 or newer)**. ### 1. Install ```sh curl -fsSL https://cerul.ai/install.sh | sh ``` Later, `cerul upgrade` installs the newest release over this one and leaves your workspace, key, and annotations alone. ### 2. Add a video ```sh cerul index ./demo.mp4 ``` On first use, follow the prompt to enter your [Gemini API key](https://aistudio.google.com/apikey), or save one ahead of time with `cerul auth set`. Cerul keeps it on your computer for future runs. > [!IMPORTANT] > Model processing sends your video data to Gemini and may incur API charges. > Run any command with `--dry-run` first to see exactly what will be sent. Run `cerul` on its own at any time to see what is indexed and what to do next. ### 3. Search and save clips ```sh cerul search "A person puts a cup on the table" cerul search "A person puts a cup on the table" --save ./clips ``` Each result is a card with the match percentage, the time range, and a link. In iTerm2, Ghostty, Kitty, or WezTerm it also shows a still frame of the moment; add `--no-preview` to turn that off. With [IINA](https://iina.io) installed the link opens the video at the matched moment instead of the beginning. Results are numbered, so `cerul open 2` plays the second moment in your video player without leaving the terminal. <details> <summary>Cleaning up</summary> ```sh cerul remove ./demo.mp4 # remove its index and sidecars; keep the video cerul remove --cache # free regenerable disk space ``` Shell completions live in the [installation guide](docs/installation.md#shell-completions). </details> [More examples →](docs/video-search.md) ## Robotics workflows Robot demonstration labels, human-hand tracking, LeRobot datasets and annotated review videos are maintained in [Cerul Robotics](https://github.com/cerul-ai/cerul-robotics). See the [migration guide](docs/robotics-migration.md) for commands and existing data. ## Let your agent do the setup Copy this prompt into an agent that can use a terminal: ```text Install Cerul by following https://github.com/cerul-ai/cerul/blob/main/docs/agent-setup.md. Help me set up my Gemini API key securely, search a local video, and save a matching clip. Teach me the commands in my language. ``` Agents that read skills can learn the whole command line from Cerul itself: ```sh cerul skill --install claude # also: codex, pi, or --dir ./skills ``` [Agent setup guide →](docs/agent-setup.md) · [Agent contract →](docs/agent.md) ## Common commands | Goal | Command | When to reach for it | | --- | --- | --- | | Index a folder | `cerul index ./videos` | Walks subfolders and skips work already done | | Preview the work | `cerul --dry-run index ./videos` | See the plan, and what will call a model, before paying for it | | Check progress | `cerul status` | After an interruption, or to find where sidecars live | | Search one video | `cerul search "opening a door" --in ./demo.mp4` | Skip the rest of the library | | Replay a result | `cerul open 2` | Open a numbered match in your video player | | Cut clips by intent | `cerul clip ./talk.mp4` | Propose quoted moments across every angle, then `--export 1,3` renders them with captions | Sidecar files preserve transcripts, annotations, and vectors alongside your media. Search indexes can be rebuilt from them without model calls. LeRobot subtask writeback is available as an explicit opt-in. ## Configure models Cerul calls your own model endpoints, so you pick the providers and pay for your own usage. Run `cerul config` to change any of it. | Stage | Default | Alternatives | | --- | --- | --- | | Multimodal search | Gemini Embedding 2, at 3072 dimensions | Any configured endpoint | | Speech transcription | Gemini, whenever a key is available | Groq, OpenAI, an OpenAI-compatible service, or disabled | | Screen text (OCR) | Runs locally, no API calls | — | Indexing builds video and text search data without generating scene descriptions, chapters, or summaries. Use `cerul analyze ./video.mp4` for scenes and an overview, with Robotics for embodied semantic labels. `--no-audio` skips speech independently of everything else. [Model endpoints and credentials →](docs/configuration.md) · [Inspect saved output →](docs/video-search.md#inspect-video-understanding) ## How it works Indexing encodes video, screen text, and optional speech into a shared multimodal space. Independent visual generation produces timed annotations for actions, interactions, and state changes, including embodied and egocentric recordings. ![Proposed Cerul architecture: multimodal indexing and search, with an independent egocentric annotation pipeline](docs/assets/cerul-architecture.png) *Architecture with AI-generated illustrative frames. Default search combines independent video, speech, screen-text, and description candidates with gated full-text matches using max fusion and capped agreement. Original evidence and timestamps remain inspectable. Robotics owns dataset writeback. See [DESIGN.md](DESIGN.md) for implemented behavior.* ## Learn more - [Documentation index](docs/README.md) - [Installation and troubleshooting](docs/installation.md) - [Video search tutorial](docs/video-search.md) - [Explicit video analysis](docs/analyze.md) - [LeRobot tutorial](https://github.com/cerul-ai/cerul-robotics/blob/main/docs/lerobot-subtasks.md) - [Model endpoints and configuration](docs/configuration.md) - [Contributing and developer integration](CONTRIBUTING.md) ## Community Questions, bug reports, and clips you are proud of are all welcome. [Discord](https://discord.gg/qHDEMQB9vN) · [Issues](https://github.com/cerul-ai/cerul/issues) · [X / Twitter](https://x.com/cerul_hq) ## License Cerul's Rust code is Apache-2.0. Bundles also contain separately licensed media tools and OCR weights; see [third-party notices](THIRD_PARTY_NOTICES.md). The [Cerul name and logo](docs/assets/README.md) identify the project and do not imply endorsement of third-party products. <a href="https://star-history.com/#cerul-ai/cerul&Date"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=cerul-ai/cerul&type=Date&theme=dark"> <img src="https://api.star-history.com/svg?repos=cerul-ai/cerul&type=Date" alt="Star history chart for cerul-ai/cerul" width="600"> </picture> </a>

저장소 README를 불러오는 중…

이 저장소의 skills

분류 대기 중

skill

직업 분류

설명

업데이트

cerul

미분류

Search local videos by meaning, exact words or reference image, analyze scenes, and export clips using the cerul CLI.

원문 언어: 영어

2026-10-08

cerul

미분류

Search local videos by meaning, exact words or reference image, analyze scenes, and export clips using the cerul CLI.

원문 언어: 영어

2026-10-08

수집된 skill 2개 중 2개를 표시합니다.

AI 어시스턴트로 설치

이 프롬프트를 복사해 사용 중인 AI 어시스턴트에 입력하세요.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/cerul-ai/cerul.