glyphh
Ada for Python: your models in Ada Cloud, https://ada.glyphh.ai, called with an API key. Python 3.9 or later, no
dependencies.
pip install glyphh
from glyphh import Ada, LimitError
ada = Ada() # GLYPHH_API_KEY from the environment; or Ada(key="glyphh_ak_...")
d = ada.decide("tickets", {"ticket": {"what": {"plan": "pro", "text": "charged twice"}}})
if d.ask: # a person should decide: d.outcome is the best guess, for them to see
send_to_a_person(d)
else:
act(d.outcome) # d.probabilities, d.expected_cost, d.receipts: the precedents it stands on
tickets = ada.model("tickets")
tickets.record({"ticket": {...}}, "refund") # a confirmed outcome: the next case learns from it
The key is made on the platform's API Keys page (https://platform.glyphh.ai), or by Claude through the Glyphh
connector; it acts in your org, with the clearance it was made with. GLYPHH_ADA_URL moves the address (a local
server under test); 3.0's GLYPHH_RUNTIME_URL and GLYPHH_RUNTIME_KEY are still read.
From nothing to a decision
tickets = ada.create_model("tickets", spec) # the spec as JSON: layers, segments, roles, output
job = tickets.import_file("history.csv", mapping={"Plan": "ticket.what.plan", "Result": "outcome"},
on_progress=lambda j: print(j.state, j.percent))
print(job.result["added"], job.result["refused"], job.result["refusals"][:3])
bt = tickets.backtest([{"settings": {"word_evidence": 0}, "name": "no word evidence"}], holdout={"newest": 200})
print(bt.result["active"]["accuracy"], bt.result["candidates"][0]["change"])
tickets.settings({"word_evidence": 0}, note="cost 8% less on the last 200", backtest=bt.id) # a new version
tickets.activate(1) # and back
tickets.export(to="tickets.zip") # everything, as a zip: never locked in
Ada versions
Every model version runs one Ada version, named ada-<major>-<minor> (-beta for a beta): ada-1-0 is the
latest stable today, ada-1-1-beta a beta. A model's answers are always computed by its own Ada version; moving
to another is your choice, made with a backtest in front of you.
for v in ada.ada.versions(): # newest first: name, status, dates, notes, your models on it
print(v.name, v.status, v.ends, v.changes_answers, v.models)
tickets = ada.create_model("tickets", spec) # the latest stable; ada="ada-1-1-beta" to opt in to a beta
info = tickets.info()
print(info.ada, info.ada_status, info.ada_notice) # ada-1-0 stable None; each of versions() has .ada too
bt = tickets.backtest(ada="ada-1-1-beta") # the active spec, learned and scored on that Ada
print(bt.result["active"]["cost"], "->", bt.result["candidates"][0]["cost"])
before = info.version
moved = tickets.upgrade("ada-1-1-beta", note="2 fewer wrong on the last 200", backtest=bt.id) # a re-encode, waited for
tickets.activate(before) # and back, on the Ada it ran before
upgrade() with no ada moves to the latest stable; an older version is a downgrade, allowed while it is kept.
A beta is never the default. A deprecated version still answers until its end date, then the model is moved to the
latest stable for you (never left unable to answer); while it runs one, or just after it was moved, the client warns
AdaDeprecationWarning (once per client). A name refused is never substituted: AdaVersionUnknownError,
AdaVersionRetiredError, AdaVersionDeprecatedError (for a new model or as an upgrade's target),
AdaBetaClosedError, AdaVersionUnavailableError, each with ada and latest (the latest stable, the fix).
The SDK speaks contract SUPPORTED_CONTRACT (5) and was made against SUPPORTED_ADA (ada-1-0, ada-1-1-beta);
newer names the server lists work as they are. A server that speaks a newer contract is refused, never read
half-understood: ClientTooOldError (contract, supported), saying to pip install -U glyphh.
Ada |
decide(model, data, output=, outputs=, include=["facts"], clearance=) (POST /v1/decide); models(), model(name), create_model(name, spec, ada=), delete_model(name); ada.versions(), ada.latest_stable(); job(id), wait(job, timeout=, on_progress=), download(job); usage() |
Model |
info() (a ModelInfo: ada, ada_status, ada_notice), spec(), set_spec(spec, note=, backtest=), settings() and settings(changes, note=, backtest=), versions() (each with ada, kernel), activate(version), upgrade(ada=, note=, backtest=, wait=), delete(); record_many(cases) (a thousand a request, in chunks), grade(id, value, output=), forget(id); decide(data, ...); learn(), learn_job(), calibrate(), backtest(candidates, ada=, holdout=, output=); import_file(path or bytes, format=, mapping=, partial=, learn=), export(format=, to=) |
Decision |
outcome, probabilities, expected_cost, ask, receipts, facts, outputs, model, version, ada; reads as 3.0's Result too (done, status, data) |
AdaVersions |
latest_stable, contract, versions (each an AdaVersion: name, kernel, status, beta, open, released, deprecated, ends, changes_answers, aliases, summary, notes, models); iterates over the versions; get(name) |
Job |
id, model, kind, state (awaiting, queued, running, done, failed), percent, result, error, download, upload; done, failed, ended |
Usage |
plan, month (YYYY-MM, UTC), resets_at (YYYY-MM-DD), models, precedents (used, max), requests (used, max, over, overage: past the month metered on Basic, Pro and Team, refused on Free), requests_per_second; None is by contract, no cap |
AdaError |
code, message, status, detail, retry_after, trace_id; typed by code: AuthError, LimitError (reason, used, max, plan, upgrade, resets_at), RateError (retry_after from Retry-After, max; waited out while the retry deadline allows), InvalidError, ModelMissingError, JobMissingError, SpecError, SpecLimitError, SpecReadingError, FewRolesError, MappingError, BusyError, NotReadyError, NoChangeError, IdempotencyError, VersionGoneError, AdaTimeoutError, UnavailableError, JobFailedError (a job that ended failed), AdaVersionError and its kinds (above), ClientTooOldError |
Every call that runs long is a job, waited for with its progress unless wait=False. Every write carries an
Idempotency-Key, so the client sends again what is safe to: a read, or a write, while Ada is unreachable for a
moment (E_UNAVAILABLE, E_TIMEOUT, a 502 to 504), and anything refused with 429, with backoff and Retry-After,
for up to Ada(retry_deadline=) seconds (default 30; 0: never).
SDK 3.0's calls still work: Model.record, query, facts, probabilities, learn and call(function, inputs)
go through POST /v1/runs and answer a Result (run_id, status, data, ...). The cloud answers every run at
once, so a decision never waits for input: it says ask.
The API and its answers' shapes are in contract/contract.json.
Pin glyphh>=3: versions up to 2.6.7 are a different, older library.
License
MIT (LICENSE).
1 maintainer
Metadata
1 maintainer
Release files for glyphh 3.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| glyphh-3.3.0.tar.gz | 31.8 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| glyphh-3.3.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 56.0 kB
Release files / glyphh-3.3.0.tar.gz
| Download URL | glyphh-3.3.0.tar.gz |
|---|---|
| Size | 31.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
75e5e18ab407675f1027fcddcd1217fabb0c1c51fcf39054208eb7725db03379
|
|
BLAKE2b-256 checksum How to use checksums |
c2ca9795b902d7440742a4115472beb240c81b7f5fb72ec6e396bd7eb3fd4da5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.
Transparency logRelease files / glyphh-3.3.0-py3-none-any.whl
| Download URL | glyphh-3.3.0-py3-none-any.whl |
|---|---|
| Size | 24.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
739bda8f93f2dccbc3f40cf63c8906764cda1413ddf34514b4e92c897bcd7baa
|
|
BLAKE2b-256 checksum How to use checksums |
edb2bfb57c012884e83e463c13a00ed8dc154437a69e2ba0070bd5e90119be7f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.
Transparency logSecurity for glyphh 3.3.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for glyphh-3.3.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
