Metadata-Version: 2.4
Name: miniverse-sdk
Version: 0.3.0
Summary: Validate and upload Dollhouse Robotics Miniverse simulation bundles.
Author: Dollhouse Robotics
License-Expression: Apache-2.0
Project-URL: Homepage, https://miniverse.bot
Project-URL: Repository, https://github.com/DollhouseRobotics/miniverse-sdk
Project-URL: Issues, https://github.com/DollhouseRobotics/miniverse-sdk/issues
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: jsonschema<5,>=4.23
Requires-Dist: keyring<26,>=25
Requires-Dist: onnx<2,>=1.17
Dynamic: license-file

# Miniverse SDK

`miniverse-sdk` installs the `miniverse` command for validating and uploading
immutable `.mini` simulation bundles to [Miniverse](https://miniverse.bot).

## Install

```bash
uv tool install miniverse-sdk
miniverse agent-help
```

Use `MINIVERSE_API_TOKEN` for CI authentication, or run:

```bash
miniverse auth login
```

Interactive access and refresh tokens are stored in a user-only file and
renewed automatically. On ephemeral Linux agents, persist
`$XDG_STATE_HOME/miniverse`, or `~/.local/state/miniverse`.

## Agent skill

The repository includes a Miniverse skill at
[`skills/miniverse/SKILL.md`](skills/miniverse/SKILL.md). Install that skill in
your agent, then follow its setup steps. The skill installs or upgrades this
package and reads the versioned instructions bundled with the CLI through
`miniverse agent-help`.

## Develop

```bash
python -m pip install -e .
python -m unittest discover -s tests -v
python -m build
python -m twine check dist/*
```

Miniverse server-side import remains authoritative. Local validation is
preflight feedback for bundle authors and agents.

## License

Apache License 2.0. See [LICENSE](LICENSE).
