> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vpod.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Contributing

> Set up a development environment and build vpod from source.

## Prerequisites

* Rust (latest stable)
* Python 3.10+

## Development setup

```bash theme={null}
# Build WASM component
./scripts/build-wasm.sh

# Install CLI
cargo install --path crates/vpod

# Install Python SDK in dev mode
pip install -e sdks/python[dev]

# Run tests
cargo test                                    # Rust tests
pytest sdks/python/tests/ -v -m integration   # Integration tests (requires WASM build)
```

## Building snapshots

The project uses pre-built Alpine snapshots from `registry.vpod.sh`. To build a custom snapshot:

```bash theme={null}
./scripts/build-default-snapshot.sh
```

This creates `dist/alpine-3.23.0-256mb.snap`.

<Warning>
  To use it locally, uncomment lines in `resolve_snapshot()` in `crates/vpod/src/main.rs`.
</Warning>

## License

This project is licensed under the **Apache License 2.0**. See the [LICENSE](https://github.com/capsulerun/vpod/blob/main/LICENSE) file for details.