Memory Hub for AI agents. Typed graph memory with episodic/semantic/working surfaces, decision replay, utility-weighted edges, and git-style branching. Zero LLM cost.
Project description
🃏 HyperStack Python SDK
Cloud memory for AI agents. Zero dependencies. 3 lines to integrate.
Install
pip install hyperstack-py
Quick Start
from hyperstack import HyperStack
hs = HyperStack("hs_your_key")
# Store a memory
hs.store("project-api", "API", "FastAPI 3.12 on AWS", stack="projects", keywords=["fastapi", "python"])
# Search memories
results = hs.search("python")
# List all cards
cards = hs.list()
# Delete a card
hs.delete("project-api")
# Get usage stats
stats = hs.stats()
print(f"Saving {stats['savings_pct']}% on tokens!")
# Auto-extract from conversation text
hs.ingest("Alice is a senior engineer. We decided to use FastAPI over Django.")
Why HyperStack?
- Zero dependencies — just Python stdlib
- No LLM costs — memory ops are free
- 94% token savings — ~350 tokens vs ~6,000 per message
- 30-second setup — get key at cascadeai.dev
API Reference
| Method | Description |
|---|---|
store(slug, title, body, stack, keywords) |
Create/update a card |
search(query) |
Search cards |
list(stack=None) |
List all cards |
get(slug) |
Get one card |
delete(slug) |
Delete a card |
stats() |
Usage summary |
ingest(text) |
Auto-extract memories |
Get a free key
→ cascadeai.dev — 50 cards free, no credit card.
License
MIT © CascadeAI
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
hyperstack_py-1.5.1.tar.gz
(9.7 kB
view details)
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 hyperstack_py-1.5.1.tar.gz.
File metadata
- Download URL: hyperstack_py-1.5.1.tar.gz
- Upload date:
- Size: 9.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.10
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
be25ac2a4b9ad5a39b00b37290fc94dd7a696e2964e2f476599329e4d518c6a1
|
|
| MD5 |
6c9aeedb1005dc8997bf7992da5cf673
|
|
| BLAKE2b-256 |
43eb7c8a52ecc96dba118bc28a92db434b0a925379252d829262dc13458bc5db
|
File details
Details for the file hyperstack_py-1.5.1-py3-none-any.whl.
File metadata
- Download URL: hyperstack_py-1.5.1-py3-none-any.whl
- Upload date:
- Size: 8.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.10
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a013364a6d10f49f866227a056d86776b659423c4b5043dd1db01657828e677f
|
|
| MD5 |
ad2e92078ec102d27c730708199e1dc4
|
|
| BLAKE2b-256 |
a2c52ce08c42195f084627e489a35de01708bfe5fab40da240904a01dbdd62af
|