# VanillaSky SDK

> VanillaSky is an open-source TypeScript SDK that lets applications turn
> grounded content and data into validated, streaming video responses rendered
> by a React player. Applications bring their own server-side LLM and retain
> ownership of credentials, media, and output.

Release status: Beta (`@vanillaskyai/video@0.5.7`). Pin this exact
version while the public API is intentionally evolving.

## Start here

- [Website](https://vanillasky.ai/): SDK overview and examples
- [Documentation](https://vanillasky.ai/docs/): installation and complete guide index
- [Getting started](https://vanillasky.ai/docs/getting-started/): shortest working integration
- [Playground](https://vanillasky.ai/playground/): live and recorded video generation
- [Provider integration](https://vanillasky.ai/docs/provider-integration/): connect OpenAI, Anthropic, or another text model
- [Prompt and input](https://vanillasky.ai/docs/prompt-and-input/): grounding and planning boundaries
- [Custom templates](https://vanillasky.ai/docs/custom-templates/): copy, edit, and create trusted scenes
- [Production guide](https://vanillasky.ai/docs/production/): reliability and deployment controls
- [Streaming protocol](https://vanillasky.ai/docs/streaming-protocol/): stable event contract
- [API reference](https://vanillasky.ai/docs/api-reference/): public exports and browser/server entry points
- [Errors and warnings](https://vanillasky.ai/docs/errors/): typed lifecycle failures and recoverable warnings
- [Persistence and replay](https://vanillasky.ai/docs/persistence/): save completed output and replay with zero provider requests
- [Packaged quickstart](https://vanillasky.ai/docs/provider-integrations/): exact Next.js and OpenAI source, plus provider-switching guidance

## Package and source

- Install: `npm install @vanillaskyai/video@0.5.7`
- [npm package](https://www.npmjs.com/package/@vanillaskyai/video)
- [GitHub repository](https://github.com/VanillaSkyAi/video)
- [Security policy](https://github.com/VanillaSkyAi/video/security/policy)
- License: Apache-2.0

VanillaSky is an SDK, not an LLM provider or hosted generation service. Model
credentials stay on the application server, production authorization must fail
closed, and model output is constrained to trusted project-owned templates
rather than executable UI code.