programasweights 0.4.8__tar.gz → 0.4.9__tar.gz

{programasweights-0.4.8 → programasweights-0.4.9}/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.4.9 (2026-09-21)
+
+- Lead quickstarts and examples with compiling your own functions, then
+  saving and reusing program IDs.
+- Reuse loaded functions in the LangChain example and serialize calls to
+  each shared instance.
+
 ## 0.4.8 (2026-09-20)
 
 - Reduce the source distribution to the SDK and files needed to build and

{programasweights-0.4.8 → programasweights-0.4.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: programasweights
-Version: 0.4.8
+Version: 0.4.9
 Summary: Compile natural language specifications into neural programs that run locally via llama.cpp.
 Project-URL: Homepage, https://programasweights.com
 Project-URL: Repository, https://github.com/programasweights/programasweights-python
@@ -46,22 +46,21 @@ pip install programasweights --extra-index-url https://pypi.programasweights.com
 ```python
 import programasweights as paw
 
-# Use a pre-compiled function (downloads once, runs locally forever)
-fn = paw.function("email-triage")
+# Compile and load your own function
+fn = paw.compile_and_load(
+    "Classify if a message needs immediate attention or can wait. "
+    "Return only 'immediate' or 'wait'."
+)
 fn("Urgent: the server is down!")        # "immediate"
 fn("Newsletter: spring picnic")          # "wait"
 
-# Compile your own from a description
+# Compile once and save the program ID
 program = paw.compile(
-    "Fix malformed JSON: repair missing quotes and trailing commas",
-    slug="json-fixer"              # optional: creates username/json-fixer handle
+    "Fix malformed JSON: repair missing quotes and trailing commas"
 )
-fn = paw.function(program.slug)    # or paw.function(program.id)
+print(program.id)  # Save this ID for future runs
+fn = paw.function(program.id)
 fn("{name: 'Alice',}")  # '{"name":"Alice"}'
-
-# Or compile and load in one step
-fn = paw.compile_and_load("Classify sentiment as positive or negative")
-fn("I love this!")  # "positive"
 ```
 
 If you specifically want the smaller browser-compatible runtime, pass `compiler="paw-4b-gpt2"`. Otherwise, omit `compiler` and let the server default decide.
@@ -73,7 +72,11 @@ Use the hosted API for fast inference in around 150 ms, without a local model do
 ```python
 import programasweights as paw
 
-with paw.function("email-triage", remote=True) as remote_fn:
+with paw.compile_and_load(
+    "Classify if a message needs immediate attention or can wait. "
+    "Return only 'immediate' or 'wait'.",
+    remote=True,
+) as remote_fn:
     print(remote_fn("Urgent: the server is down!"))
 ```
 

{programasweights-0.4.8 → programasweights-0.4.9}/PYPI_README.md

@@ -15,22 +15,21 @@ pip install programasweights --extra-index-url https://pypi.programasweights.com
 ```python
 import programasweights as paw
 
-# Use a pre-compiled function (downloads once, runs locally forever)
-fn = paw.function("email-triage")
+# Compile and load your own function
+fn = paw.compile_and_load(
+    "Classify if a message needs immediate attention or can wait. "
+    "Return only 'immediate' or 'wait'."
+)
 fn("Urgent: the server is down!")        # "immediate"
 fn("Newsletter: spring picnic")          # "wait"
 
-# Compile your own from a description
+# Compile once and save the program ID
 program = paw.compile(
-    "Fix malformed JSON: repair missing quotes and trailing commas",
-    slug="json-fixer"              # optional: creates username/json-fixer handle
+    "Fix malformed JSON: repair missing quotes and trailing commas"
 )
-fn = paw.function(program.slug)    # or paw.function(program.id)
+print(program.id)  # Save this ID for future runs
+fn = paw.function(program.id)
 fn("{name: 'Alice',}")  # '{"name":"Alice"}'
-
-# Or compile and load in one step
-fn = paw.compile_and_load("Classify sentiment as positive or negative")
-fn("I love this!")  # "positive"
 ```
 
 If you specifically want the smaller browser-compatible runtime, pass `compiler="paw-4b-gpt2"`. Otherwise, omit `compiler` and let the server default decide.
@@ -42,7 +41,11 @@ Use the hosted API for fast inference in around 150 ms, without a local model do
 ```python
 import programasweights as paw
 
-with paw.function("email-triage", remote=True) as remote_fn:
+with paw.compile_and_load(
+    "Classify if a message needs immediate attention or can wait. "
+    "Return only 'immediate' or 'wait'.",
+    remote=True,
+) as remote_fn:
     print(remote_fn("Urgent: the server is down!"))
 ```
 

{programasweights-0.4.8 → programasweights-0.4.9}/README.md

@@ -15,22 +15,21 @@ pip install programasweights --extra-index-url https://pypi.programasweights.com
 ```python
 import programasweights as paw
 
-# Use a pre-compiled function (downloads once, runs locally forever)
-fn = paw.function("email-triage")
+# Compile and load your own function
+fn = paw.compile_and_load(
+    "Classify if a message needs immediate attention or can wait. "
+    "Return only 'immediate' or 'wait'."
+)
 fn("Urgent: the server is down!")        # "immediate"
 fn("Newsletter: spring picnic")          # "wait"
 
-# Compile your own from a description
+# Compile once and save the program ID
 program = paw.compile(
-    "Fix malformed JSON: repair missing quotes and trailing commas",
-    slug="json-fixer"              # optional: creates username/json-fixer handle
+    "Fix malformed JSON: repair missing quotes and trailing commas"
 )
-fn = paw.function(program.slug)    # or paw.function(program.id)
+print(program.id)  # Save this ID for future runs
+fn = paw.function(program.id)
 fn("{name: 'Alice',}")  # '{"name":"Alice"}'
-
-# Or compile and load in one step
-fn = paw.compile_and_load("Classify sentiment as positive or negative")
-fn("I love this!")  # "positive"
 ```
 
 If you specifically want the smaller browser-compatible runtime, pass `compiler="paw-4b-gpt2"`. Otherwise, omit `compiler` and let the server default decide.
@@ -42,7 +41,11 @@ Use the hosted API for fast inference in around 150 ms, without a local model do
 ```python
 import programasweights as paw
 
-with paw.function("email-triage", remote=True) as remote_fn:
+with paw.compile_and_load(
+    "Classify if a message needs immediate attention or can wait. "
+    "Return only 'immediate' or 'wait'.",
+    remote=True,
+) as remote_fn:
     print(remote_fn("Urgent: the server is down!"))
 ```
 

{programasweights-0.4.8 → programasweights-0.4.9}/programasweights/__init__.py

@@ -5,12 +5,16 @@ functions that run locally.
 Quick start:
     import programasweights as paw
 
-    # Use a pre-compiled function (downloads once, runs locally forever)
-    fn = paw.function("email-triage")
+    # Compile and load your own function
+    fn = paw.compile_and_load(
+        "Classify if a message needs immediate attention or can wait. "
+        "Return only 'immediate' or 'wait'."
+    )
     fn("Urgent: server is down!")  # "immediate"
 
-    # Compile your own from a description
+    # Compile once and save the program ID
     program = paw.compile("Fix malformed JSON: repair missing quotes and trailing commas")
+    print(program.id)  # Save this ID for future runs
     fn = paw.function(program.id)
     fn("{name: 'Alice',}")  # '{"name":"Alice"}'
 
@@ -27,7 +31,7 @@ try:
     from importlib.metadata import version as _meta_version
     __version__ = _meta_version("programasweights")
 except Exception:
-    __version__ = "0.4.8"
+    __version__ = "0.4.9"
 
 from ._output import ProgressCallback, ProgressEvent, report_progress
 from .cache import CachedProgram

{programasweights-0.4.8 → programasweights-0.4.9}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "programasweights"
-version = "0.4.8"
+version = "0.4.9"
 description = "Compile natural language specifications into neural programs that run locally via llama.cpp."
 readme = "PYPI_README.md"
 requires-python = ">=3.9"