getskua 0.10.0a2

Shareable URLs for notebook outputs — snap any chart, DataFrame, or figure into a live link

Skua

Shareable URLs for notebook outputs

One function call turns plots, DataFrames, and text into permanent links. Re-run the cell to update — same URL, fresh results.

Installation

pip install getskua

No setup required. No account, no API key.

Quick Start

import matplotlib.pyplot as plt
import skua

fig, ax = plt.subplots()
ax.plot([1, 2, 3], [1, 4, 9])
ax.set_title("Quadratic Growth")

result = skua.snap(fig, title="Quadratic Growth")
print(result.url)  # https://skua.dev/s/abc123

Share the URL with anyone. Call skua.snap() again with the same title to update in place.

CLI

Works with any tool that can run shell commands — AI coding assistants, CI pipelines, scripts.

skua snap chart.png --title "Q3 Revenue"
skua snap data.csv --title "Sales Data" --public --tags "finance,q3"
skua snap plot.json --title "Interactive Chart"
cat report.txt | skua snap - --type text --title "Analysis"

Use --json for machine-readable output:

skua snap chart.png --title "Chart" --json
# {"url": "https://skua.dev/s/abc123", "id": "abc123", "visibility": "public"}

Supported Types

Skua auto-detects the object type and picks the right serializer:

• Matplotlib figures — high-DPI PNG
• Plotly figures — fully interactive (zoom, pan, hover, export)
• Pandas DataFrames — sortable, filterable tables
• Polars DataFrames — same interactive tables (LazyFrames collected automatically)
• NumPy arrays — rendered as tables
• PIL Images — saved as PNG
• Lists of dicts — rendered as tables (handy for HuggingFace pipelines, eval loops)
• PyTorch / TensorFlow tensors — image tensors as PNG, others as tables
• Anything else — falls back to string representation

API

skua.snap(obj, title, description=None, public=None, tags=None)

Capture and share a Python object. Returns a SnapResult with .url and .metadata. In Jupyter, the original object is displayed inline.

• tags — optional list of strings for categorization (max 20 tags, 30 chars each). Displayed on the snapshot page and profile listing.

skua.configure(public=None, api_url=None, web_url=None, token=None)

Set session-wide defaults. Call once at the top of a notebook — per-call arguments override.

skua.login()

Open the browser to verify your email. Verified accounts get 90-day retention (vs 7 days), 50 snapshots (vs 10), and a public profile page at skua.dev/u/username.

skua.auth("sk_...")

Paste the token you receive by email after skua.login().

Limits

Anonymous sessions work out of the box:

• 7-day retention, 10 snapshots, 20 uploads/hour, 10 MB per snapshot

Verify your email to unlock:

• 90-day retention (resets on update, 1-year max), 50 snapshots, 10 MB per snapshot

Privacy

Every snapshot is accessible to anyone who has its URL. URLs contain random IDs that are not guessable or listed anywhere, but there is no login-gated access control. The public flag only controls whether a snapshot appears on your profile page — it does not restrict access to the URL itself. Do not snap sensitive data.

Documentation

Full docs, live examples, and the API reference at skua.dev/docs.

License

MIT

Support

Questions or feedback? Email [e-mail] or open an issue on GitHub.