Python SDK

pip install superartifacts

import os

from superartifacts import SuperArtifacts

sa = SuperArtifacts(api_key=os.environ["SUPERARTIFACTS_API_KEY"])

print(sa.account.whoami()["handle"])

sa.artifacts.publish(
    slug="hello",
    html="<!doctype html><h1>Hello</h1>",
)

for artifact in sa.artifacts.list()["artifacts"]:
    print(artifact["slug"])

for row in sa.data.iter_artifact_rows(artifact="hello"):
    print(row)

import asyncio

from superartifacts import AsyncSuperArtifacts


async def main():
    async with AsyncSuperArtifacts() as sa:
        print(await sa.account.whoami())
        async for row in sa.data.iter_artifact_rows(artifact="hello"):
            print(row)


asyncio.run(main())

SuperArtifacts(
    api_key=None,  # or SUPERARTIFACTS_API_KEY
    base_url="https://superartifacts.app",
    timeout=60.0,  # seconds
    max_retries=2,
    http_client=None,  # your own httpx.Client; yours to close
)

from pathlib import Path

from anthropic import Anthropic
from superartifacts import SuperArtifacts

# Your model, your key. We run no inference.
msg = Anthropic().messages.create(
    model="claude-haiku-5-5",
    max_tokens=4000,
    messages=[{
        "role": "user",
        "content": "A launch checklist. HTML only.",
    }],
)
Path("checklist.html").write_text(
    msg.content[0].text
)

# We host the file. Reads SUPERARTIFACTS_API_KEY
sa = SuperArtifacts()
page = sa.artifacts.publish_file(
    "checklist.html"
)
print(page["url"])

from pathlib import Path

sa.artifacts.publish(
    slug="rsvp",
    html=Path("rsvp.html").read_text(),
    policy={
        "policyVersion": 1,
        "writes": "upsert",
        "perUser": "single",
        "read": "own",
        "retentionDays": None,
        "recordCap": {"perVisitor": 1, "perArtifact": 500},
        "fields": [
            {"name": "attending", "type": "boolean", "required": False, "pii": "none", "description": "Yes or no."},
        ],
    },
)

for row in sa.data.iter_artifact_rows(artifact="rsvp"):
    print(row)

sa.shares.add_to_artifact(
    artifact="launch-notes",
    emails=["dana@example.com"],
    role="commenter",
)

from superartifacts import NotFoundError

try:
    sa.artifacts.get(artifact="missing")
except NotFoundError as error:
    print(error.code, error.message)

for row in sa.data.iter_rows(dataset="signups"):
    print(row)
for row in sa.data.iter_artifact_rows(artifact="hello"):
    print(row)
for entry in sa.entries.iter(collection="posts"):
    print(entry)
for mention in sa.mentions.iter():
    print(mention)

staged = sa.uploads.upload({"images/hero.png": "./hero.png", "notes.txt": b"hello"})

sa.artifacts.publish(
    slug="hello",
    html='<!doctype html><img src="images/hero.png">',
    uploads=staged["uploadId"],
)