This release is a pre-release and may not be stable for production use.
datasette-agent-sprites
Datasette Agent tools for working with Fly Sprites - persistent, hardware-isolated Linux environments with a REST API.
Installation
Install this plugin in the same environment as Datasette.
datasette install datasette-agent-sprites
Configuration
This plugin uses datasette-secrets to manage the Sprites API key. You can get a token from https://sprites.dev/account.
There are two ways to configure it:
Using an environment variable:
export DATASETTE_SECRETS_SPRITES_API_KEY="your-token-here"
Or if you have datasette-secrets configured with an encrytion key:
Using the datasette-secrets UI: Navigate to /-/secrets in your Datasette instance and set the SPRITES_API_KEY secret.
Tools
This plugin provides the following tools to the Datasette Agent:
| Tool | Description |
|---|---|
| list_sprites | List all available Sprites. Optionally filter by name prefix. |
| create_sprite | Create a new Sprite with a given name. It starts cold and warms on first use. |
| get_sprite | Get details and status of a specific Sprite. |
| exec_on_sprite | Execute a shell command on a Sprite via bash -lc. Returns stdout, stderr, and exit code. |
| delete_sprite | Permanently delete a Sprite and all its data. |
| read_sprite_file | Read a file from a Sprite's filesystem. Images are displayed inline; text files are returned directly. |
| write_sprite_file | Write text content to a file on a Sprite. Creates parent directories automatically. |
Development
To set up this plugin locally, first checkout the code. You can confirm it is available like this:
cd datasette-agent-sprites
# Confirm the plugin is visible
uv run datasette plugins
To run the tests:
uv run pytest
Metadata
Release files for datasette-agent-sprites 0.1a0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| datasette_agent_sprites-0.1a0.tar.gz | 11.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| datasette_agent_sprites-0.1a0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 21.8 kB
Release files / datasette_agent_sprites-0.1a0.tar.gz
| Download URL | datasette_agent_sprites-0.1a0.tar.gz |
|---|---|
| Size | 11.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0b4945c34a09afa4d0f3bdc367096973ace1f5f46ecc675d494615658a4a9255
|
|
BLAKE2b-256 checksum How to use checksums |
4e6e9dbaa9ffad28b26f5937eee31b04c172c87d9db29259f91c7db5c81597cd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on May 21, 2026.
Transparency logRelease files / datasette_agent_sprites-0.1a0-py3-none-any.whl
| Download URL | datasette_agent_sprites-0.1a0-py3-none-any.whl |
|---|---|
| Size | 10.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e1b26838ddd3804c4d8274005d747b36cf1f1d1fc465e58fd195b972c8af0ebc
|
|
BLAKE2b-256 checksum How to use checksums |
b5b6fab084b539acde04092eca468ecfb0c781526e7a6461e8801f2cfae4ea6c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on May 21, 2026.
Transparency log
