# vidarax

> Self-hosted video intelligence engine. Streams in, structured events out.

## Docs

- [What is vidarax](https://vidarax.cosminbararu.com/docs): A self-hosted media runtime that turns live streams and recordings into an ordered event timeline.
- [Quickstart](https://vidarax.cosminbararu.com/docs/quickstart): Build the server, analyze a video, and read its events.
- [Agent workflows](https://vidarax.cosminbararu.com/docs/agents): Run grounded media reviews from a compatible agent harness without hand-building the local audio environment.
- [Architecture](https://vidarax.cosminbararu.com/docs/architecture): How Vidarax keeps ordered media work bounded and commits it to one recoverable event timeline.
- [Ingest](https://vidarax.cosminbararu.com/docs/ingest): Supported sources, the ffmpeg decode sidecar, the drain-before-write rule, and decoder warm-up.
- [Local audio perception](https://vidarax.cosminbararu.com/docs/audio): Event tagging, selective speech recognition, and spoken feedback for recorded files and live WebRTC audio.
- [Gemini Flash review](https://vidarax.cosminbararu.com/docs/gemini-flash): Gemini 3.8 Flash routing, dense recorded review controls, and evidence limits.
- [Mage-VL debug modes](https://vidarax.cosminbararu.com/docs/mage-vl): Compare codec-native video tokens with frame sampling and inspect proactive streaming decisions.
- [The per-frame filter](https://vidarax.cosminbararu.com/docs/gate): The deterministic per-frame filter, semantic novelty reuse, and tiered model escalation.
- [API reference](https://vidarax.cosminbararu.com/docs/api): Per-route contracts, the error envelope, and server configuration reference.
- [Events and SDK](https://vidarax.cosminbararu.com/docs/events): Event shapes and kinds, per-kind payloads, markers, query and search, and the TypeScript SDK.
- [Policy rollouts](https://vidarax.cosminbararu.com/docs/policy-rollouts): Durable feedback, candidate replay, and generation-safe policy promotion.
- [Trigger programs](https://vidarax.cosminbararu.com/docs/triggers): A bounded instruction set for turning perception signals into durable actions.
- [Edge deployment](https://vidarax.cosminbararu.com/docs/edge): Signed binary model releases with shadow, canary, activation, and rollback.
- [Operations](https://vidarax.cosminbararu.com/docs/operations): Deployment, observability, hardening, and release checks.
- [Development](https://vidarax.cosminbararu.com/docs/development): Workspace layout, how to build and test, and contributing basics.

## Internals

- [Media plane](https://vidarax.cosminbararu.com/docs/internals/media-plane): The per-session worker threads, the bounded channels between them, and how every buffer pool is sized as a sum over in-flight positions.
- [Decode sidecar](https://vidarax.cosminbararu.com/docs/internals/decode-sidecar): The long-lived ffmpeg subprocess, its reader thread and bounded handoff, and the limits of the drain-before-write rule.
- [Filter internals](https://vidarax.cosminbararu.com/docs/internals/gate-internals): Per-frame signals, branchless decision dispatch, deferred commit, and tiered escalation.
- [State and cancellation](https://vidarax.cosminbararu.com/docs/internals/state-and-cancellation): AppState layout, RAII slot reservation, the single-winner delete protocol, and how request cancellation is kept away from session ownership.
- [WAL and events](https://vidarax.cosminbararu.com/docs/internals/wal-and-events): The write-ahead log format, event families and append ownership, the event sink, and replay checks.
- [WebRTC ingest](https://vidarax.cosminbararu.com/docs/internals/webrtc-ingest): The WHIP signalling path, how RTP becomes Annex B decoder input, and the session lifecycle from offer to teardown.
- [Allocation discipline](https://vidarax.cosminbararu.com/docs/internals/allocation-discipline): The counting allocator in the perf probe, pointer-identity tests for pool reuse, and executable release checks.

## Agent resources

- [llms-full.txt](https://vidarax.cosminbararu.com/docs/llms-full.txt): The full Markdown of every page in one file.
- [Page Markdown](https://vidarax.cosminbararu.com/docs/index.md): Append `.md` to any page URL to fetch that page as raw Markdown.
- [JSON API](https://vidarax.cosminbararu.com/docs/api/docs/pages.json): Page index of the JSON docs API; each entry links the page's JSON and Markdown forms. Described by the OpenAPI document at https://vidarax.cosminbararu.com/docs/openapi.json.
- [API catalog](https://vidarax.cosminbararu.com/docs/.well-known/api-catalog): RFC 9727 linkset of the APIs documented here.
- [AI catalog](https://vidarax.cosminbararu.com/docs/.well-known/ai-catalog.json): ARD manifest of the agent-facing resources on this site (MCP server, skills, APIs).
- [agent-readability.json](https://vidarax.cosminbararu.com/docs/agent-readability.json): Manifest of every agent-facing artifact on this site.
- [Sitemap](https://vidarax.cosminbararu.com/docs/sitemap.xml): Every indexable page URL with its last-modified date.