engrammatic 0.1.2

Python client for Engrammatic — ingest-time anomaly, novelty and fraud detection with binary hyperdimensional computing.

Engrammatic Python client

Ingest-time anomaly, novelty and fraud detection with binary hyperdimensional computing — encode each event once, compare with XOR + popcount. This package is the official Python client for the Engrammatic service. It has zero dependencies (stdlib only).

Install

pip install engrammatic

Quickstart

Sign in with Google at app.engrammatic.ai — new accounts get $5 of starting credit — and copy your API key from the dashboard.

from engrammatic import Client

c = Client(api_key="ek_...")

# score one event (and learn it)
r = c.detect({"path": "/wp-admin.php", "status": 404, "ua": "python-requests"})
print(r)   # {"score": ..., "best_similarity": ..., "is_anomaly": ..., "balance_usd": ...}

# batch log ingestion
c.ingest([{"path": "/api/v1/orders", "status": 200, "ms": 41},
          {"path": "/api/v1/orders", "status": 503, "ms": 9040}])

# similarity search over what the memory has seen
hits = c.query({"path": "/api/v1/orders", "status": 503}, k=5)

# store without scoring
c.write({"path": "/healthz", "status": 200})

# current plans/rates (no key needed)
print(Client().pricing())

Out-of-credit responses raise EngrammaticError with .out_of_credit == True (HTTP 402) — top up in the console.

What it's for (and honestly, what it's not)

Engrammatic sits alongside your log platform (Hydrolix / Splunk / Datadog), scoring events at ingest time for combinatorial novelty — field combinations your stack hasn't seen — at $0.30–$1.00 per million events. If your problem is a 5xx spike, use a threshold; a numeric outlier, a z-score; known signatures, a WAF. Engrammatic earns its keep on the anomalies those baselines can't express.

Notes

• This release is the remote client only; the embedded/local engine is not included (Client(local=True) raises).
• AI agents: the service publishes a manifest at https://app.engrammatic.ai/.well-known/agent.json and supports programmatic top-up — see the console.
• Docs & contact: engrammatic.ai · [e-mail]