# falaw

> Agent-friendly Python facade over fal.ai for generating and managing AI media (images, video, audio).


## Pages

- [falaw](index.html.md): Agent-friendly Python facade over fal.ai for generating and managing AI media (images, video, audio)...
- [API reference](api.html.md): | `falaw`   | falaw: agent-friendly Python facade over fal.ai for AI media generation.   |
- [falaw](_autosummary/falaw.html.md): falaw: agent-friendly Python facade over fal.ai for AI media generation.
- [falaw.journal](_autosummary/falaw.journal.html.md): Agent journal: append-only log of notes, issues and improvements.
- [falaw.account](_autosummary/falaw.account.html.md): Account health probe.
- [falaw.backends](_autosummary/falaw.backends.html.md): Execution backend registry — where `CallPlan.backend` dispatches (falaw#15).
- [falaw.base](_autosummary/falaw.base.html.md): Core types: ToolSpec and ModelRecord.
- [falaw.bridges](_autosummary/falaw.bridges.html.md): Bridges: derive auxiliary surfaces (skill, MCP, HTTP service) from the tool registry.
- [falaw.bridges.mcp](_autosummary/falaw.bridges.mcp.html.md): MCP bridge: expose every falaw tool as an MCP tool.
- [falaw.bridges.service](_autosummary/falaw.bridges.service.html.md): HTTP service bridge (planned): expose falaw tools as a `qh` app.
- [falaw.bridges.skill](_autosummary/falaw.bridges.skill.html.md): Render a Claude SKILL.md (and references) from the falaw tool registry.
- [falaw.cache](_autosummary/falaw.cache.html.md): Content-addressed cache for fal calls.
- [falaw.canonical](_autosummary/falaw.canonical.html.md): One canonical byte-form for everything falaw hashes (falaw#17).
- [falaw.content](_autosummary/falaw.content.html.md): Content addressing for fal-produced media — identify a file by *what it is*.
- [falaw.core](_autosummary/falaw.core.html.md): Wrapper over `fal_client.subscribe` with progress events and auto-journaling.
- [falaw.corpus](_autosummary/falaw.corpus.html.md): Extract model records from `misc/docs/falaw.md`.
- [falaw.cost](_autosummary/falaw.cost.html.md): Cost estimation: ModelRecord.cost_estimate + Scene rollups.
- [falaw.degrade](_autosummary/falaw.degrade.html.md): Where falaw sends “I carried on, but you should know” — one collection point.
- [falaw.errors](_autosummary/falaw.errors.html.md): Typed exceptions for falaw operations.
- [falaw.events](_autosummary/falaw.events.html.md): Structured progress events for fal calls.
- [falaw.liveness](_autosummary/falaw.liveness.html.md): Is a catalogued endpoint still deployed? (falaw#76)
- [falaw.llm_prices](_autosummary/falaw.llm_prices.html.md): One first-party LLM price table: what a direct Anthropic / OpenAI call costs (falaw#81).
- [falaw.llm_rates](_autosummary/falaw.llm_rates.html.md): Per-routed-model LLM rates: the data behind a *ceiling* quote (falaw#50, option A).
- [falaw.llm_rates_refresh](_autosummary/falaw.llm_rates_refresh.html.md): Refresh proposals for the LLM rate table, never a silent overwrite (falaw#56).
- [falaw.local](_autosummary/falaw.local.html.md): Local utilities: ffmpeg + PIL glue for stitching fal outputs.
- [falaw.operations](_autosummary/falaw.operations.html.md): Task-level verbs: stable, agent-friendly entry points.
- [falaw.operations.audio](_autosummary/falaw.operations.audio.html.md): Audio operations: text-to-speech and friends.
- [falaw.operations.avatar](_autosummary/falaw.operations.avatar.html.md): Avatar / lip-sync operations and composers.
- [falaw.operations.images](_autosummary/falaw.operations.images.html.md): Image-generation and image-manipulation operations.
- [falaw.operations.llm](_autosummary/falaw.operations.llm.html.md): LLM-driven tools: text completion, screenplay → Scene IR, IR editing.
- [falaw.operations.preproduction](_autosummary/falaw.operations.preproduction.html.md): Pre-production: produce reusable identity anchors for a Scene.
- [falaw.operations.render](_autosummary/falaw.operations.render.html.md): Beat / shot / scene rendering with caching.
- [falaw.operations.video](_autosummary/falaw.operations.video.html.md): Video-generation operations: text-to-video and image-to-video.
- [falaw.outcomes](_autosummary/falaw.outcomes.html.md): Per-call outcomes of running a `falaw.Plan` — the partial-result type.
- [falaw.plan](_autosummary/falaw.plan.html.md): Plan / Execute primitives — separate planning (data) from execution (effects).
- [falaw.pricing](_autosummary/falaw.pricing.html.md): Read fal’s pricing API into `models.json` cost estimates (falaw#18).
- [falaw.prune](_autosummary/falaw.prune.html.md): Capacity management for the falaw cache: see what is on disk, and reclaim it.
- [falaw.refresh](_autosummary/falaw.refresh.html.md): Refresh fal.ai docs locally with conditional GETs.
- [falaw.registry](_autosummary/falaw.registry.html.md): Tool and model registries.
- [falaw.reprice](_autosummary/falaw.reprice.html.md): Re-quote a persisted `falaw.Plan` at today’s rates (falaw#60).
- [falaw.results](_autosummary/falaw.results.html.md): Result wrapper: parse fal responses into typed assets, lazy download.
- [falaw.scene](_autosummary/falaw.scene.html.md): Scene IR: the editable structure that survives all the way to the pixels.
- [falaw.schema_export](_autosummary/falaw.schema_export.html.md): Export the Python SSOT as committed JSON for the TypeScript twin (`ts/`).
- [falaw.session](_autosummary/falaw.session.html.md): Session: optional stateful controller over a sequence of falaw operations.
- [falaw.testing](_autosummary/falaw.testing.html.md): Make a suite that uses falaw genuinely offline — the fake asset transport.
- [For AI agents](ai-agents.html.md): `falaw` ships artifacts for coding agents alongside its code. This page lists
- [About this build](about-this-build.html.md): This documentation was built on **2026-10-14 12:58 UTC** from commit <a href="https://github.com/ree...

## Optional

- [falaw.md](falaw.md): Complete documentation in a single file.

## Build

- [build_info.json](build_info.json): build provenance (commit, version, tool versions, whether the docs match the package)