getskua 0.11.0a8

Shareable URLs for notebook outputs — record 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

skua.init("Q3 Review")

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

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

Share the URL with anyone. Call skua.record() again with the same title to update in place — handy for iterating, and also the simplest way to change a record's visibility.

CLI

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

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

Use --json for machine-readable output:

skua record chart.png --title "Chart" --json
# {"url": "https://skua.dev/r/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.init(name=None, visibility=None)

Open a named session scope. Call once per notebook/kernel before any skua.record().

• name — custom session name (max 100 chars). If omitted, a random "Adverb Verbing" name is generated and printed.
• visibility — session-default visibility for every subsequent record(). One of "public", "unlisted", "private". Per-call overrides still win. Omit to fall back to the server default (public).

skua.record(obj, title, description=None, visibility=None, tags=None)

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

• visibility — "public", "unlisted", or "private". Defaults to the session default or "public".
  • public — listed on your profile, URL shareable, discoverable.
  • unlisted — URL works for anyone, but not listed on your profile.
  • private — only you can view (requires a verified account).
• tags — optional list of strings for categorization (max 20 tags, 30 chars each). Displayed on the record page and profile listing.

Re-calling record() with the same (session, title) updates the existing record in place — including its visibility.

skua.login()

Open the browser to verify your email. Verified accounts get 365-day retention (vs 90 days), no hard record cap (reach out if you hit one), and a public profile page at skua.dev/u/username.

skua.auth("sk_...")

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

Environment

All infrastructure-level settings are read from environment variables (rarely needed):

• SKUA_API_URL — API host (default: https://api.skua.dev)
• SKUA_WEB_URL — web host (default: https://skua.dev)
• SKUA_TOKEN — auth token (alternative to skua.auth() / ~/.skua/token)

Limits

Anonymous usage works out of the box:

• 90-day retention, 10 records per device, 20 uploads/hour, 10 MB per record

Verify your email to unlock:

• 365-day retention (resets on update), no hard record cap (reach out if you hit one), 10 MB per record

Privacy

public and unlisted records are accessible to anyone who has the URL — URLs contain random IDs that are not guessable, but there's no login-gated access control for these. private records are cookie/token-gated and only viewable by you. Do not record sensitive data at public or unlisted.

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.