Budget-Safe AI Agents with Local Caching and Circuit Breakers.
Project description
🛡️ Zocrity — The Emergency Brake for AI Agents
Stop API hallucination loops before they drain your budget. Zocrity wraps your agent runs with a hard stop so runaway retries, repeated prompts, and token spirals don't turn into surprise $100 bills.
💸 The Problem: The 'Infinite Loop' Tax
AI Agents are expensive. A single coding loop or 'hallucination spiral' can burn through your OpenAI credits while you sleep. Most developers don't realize they've spent $50 until the invoice hits.
⚡ The Solution: Zinc Infrastructure
Zocrity is a local-first, zero-config utility that intercepts your LLM calls to provide:
🛑 Hard-Stop Budgets: Set a limit (e.g., $2.00). Zocrity severs the connection locally the moment you hit it.
🚀 1,000x Speedup: Our Local Zinc Cache serves repeated prompts from a local SQLite database in ~5ms. Save 100% on compute for repeated tests.
🤖 Loop Detection: Automatically kills agents that repeat the same prompt structure 3+ times.
📊 Transparent Reports: Run zocrity.report() to see exactly how much money and time you've saved.
📦 Quick Install
pip install zocrity
🛠️ Usage (2 Lines of Code)
import zocrity
# Protect your wallet & enable the lightning-fast cache
zocrity.shield(mode="HALT", enable_cache=True)
# Your existing OpenAI/LangChain code stays exactly the same!
🏆 The Sentinel List
We are building the world's safest AI infrastructure. The first 100 contributors/users to fork this repo and submit a PR or issue get listed here as Zinc Sentinels.
- Zocrity-Ai — Founder & Lead Architect
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file zocrity-0.1.2.tar.gz.
File metadata
- Download URL: zocrity-0.1.2.tar.gz
- Upload date:
- Size: 13.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
39184d5f34cbf7f92d7dad32e35a51fd5a38b22512550aef30e809ee316baf68
|
|
| MD5 |
a6bc086bceb775d2ec3dc45e3473d411
|
|
| BLAKE2b-256 |
5f7e57548cf71c102d381059d0df268b95a786ed70359983e4f23ee8e6927df7
|
File details
Details for the file zocrity-0.1.2-py3-none-any.whl.
File metadata
- Download URL: zocrity-0.1.2-py3-none-any.whl
- Upload date:
- Size: 12.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
16f8e028c5c83354355143cc1bbc420dddc35b036985f772d67515906857982c
|
|
| MD5 |
fc6e06b23a70c0383932923b0fc66292
|
|
| BLAKE2b-256 |
e40c52c5a786a8ab5f1351c6d649247ad8b7c5988746921bab9c8ee91fd43aab
|