puras

The Python SDK + CLI for Puras — deploy long-running, multi-step agentic skills and call them from anywhere.

pip install puras        # or: uv tool install puras  /  uvx puras

You get two things in one package:

  • import puras — the runtime SDK your deployed skills use (media.generate_image/video/audio, media.transcribe, secret, load_path, subagent.run).
  • puras — a CLI to scaffold, deploy, run, and tail skills from your terminal and CI.

Quickstart

puras login                       # paste a workspace API key (created in the dashboard)
puras init --name "My Skillpack"  # creates the skillpack + writes puras.yaml + scaffolds my-skill/
puras deploy                      # zips ./ and pushes an active deployment
puras run my-skill -i prompt="hi" # submit a job and wait for the result

Want a worked example instead of a blank slate? puras init --template hello-world scaffolds the full hello-world pack — an agentic skill, a deterministic skill, a custom tool, and two subagents.

Auth

  • Interactive: puras login stores your key in ~/.puras/config.json.
  • CI: set PURAS_API_KEY (and optionally PURAS_API_BASE) in the environment — no login step, no browser.
PURAS_API_KEY=puras_live_… puras deploy --skillpack <id>

Commands

Command What it does
puras login / logout / whoami manage stored credentials
puras init create a skillpack, write puras.yaml, scaffold a starter (--template hello-world for the full example)
puras skillpacks list your skillpacks
puras deploy [path] bundle a dir and push a deployment (--no-activate)
puras deployments list deployments for the current skillpack
puras activate <version|id> make a deployment the active one
puras run <skill> -i k=v submit a job and wait (--async, --json)
puras logs <job_id> stream a job's events until it finishes
puras feedback <job_id> --up|--down rate a result (👍/👎 + --comment) so you can see which skills run well
puras secrets set/ls/rm manage skillpack secrets
puras pull download the active bundle

The skillpack is resolved from --skillpack <id|slug>, else the nearest puras.yaml. The CLI is a convenience over the public HTTP API (POST /v1/jobs, /v1/skillpacks/{id}/deployments, …) — anything it does, you can do with curl and a Bearer key.

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.20.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for purasco from gravatar.com purasco

Credits

Author: Puras

Requires

Python >=3.10

Provides Extra

local

Tags

agents ai backend cli mcp puras sdk

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

puras-0.19.0.tar.gz (35.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

puras-0.19.0-py3-none-any.whl (42.4 kB view details)

Uploaded Python 3

File details

Details for the file puras-0.19.0.tar.gz.

File metadata

  • Download URL: puras-0.19.0.tar.gz
  • Upload date:
  • Size: 35.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for puras-0.19.0.tar.gz
Algorithm Hash digest
SHA256 2c1d55763cb29efd697f0ea27dd08041d6e6d3fbf40c3f923a527a569a0a96f8
MD5 3ce8ee356e0abdc5d603439fc3405b68
BLAKE2b-256 48c561f5c96243ff15c9bb4adc5a598a2c360488c7dc46a6a9202f9a05eb3248

See more details on using hashes here.

Provenance

The following attestation bundles were made for puras-0.19.0.tar.gz:

Publisher: publish.yml on PurasAI/puras

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file puras-0.19.0-py3-none-any.whl.

File metadata

  • Download URL: puras-0.19.0-py3-none-any.whl
  • Upload date:
  • Size: 42.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for puras-0.19.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b82ec19cb0529428562a5f2d0f39ae47e788bbb3c518d2e02b9b13fa309890bf
MD5 367efaa2a5972420707620c9d90e6dcf
BLAKE2b-256 a746d43cf7af61c2906254e740927fca3371e6cc530dc24f5e5b00c23a6f1250

See more details on using hashes here.

Provenance

The following attestation bundles were made for puras-0.19.0-py3-none-any.whl:

Publisher: publish.yml on PurasAI/puras

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page