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.0.tar.gz
(8.6 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.0.tar.gz.
File metadata
- Download URL: hyperstack_py-1.5.0.tar.gz
- Upload date:
- Size: 8.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.10
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6cab22826c35dacb86b624d33056a28ad97635646ffcaf1faf48d5b0ec6094bf
|
|
| MD5 |
bd87e19302c8ee59ab3a69c169a63d73
|
|
| BLAKE2b-256 |
a6a240befba53f8d5acbfbeefe7a38dce4569dbdda591fcd054d52766fd291b5
|
File details
Details for the file hyperstack_py-1.5.0-py3-none-any.whl.
File metadata
- Download URL: hyperstack_py-1.5.0-py3-none-any.whl
- Upload date:
- Size: 8.0 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 |
97e33c70e66de639b750b9c69c9291d17315dbce2748cc08199f1c5bcf546c6b
|
|
| MD5 |
36dcae08b3435a419eed7821fb158a5b
|
|
| BLAKE2b-256 |
3d3dc2480f2f6406fd380899d196375944889f1bb5759069f38ccf2a8f46e40a
|