vaas-x

Persistent, outcome-grounded memory for AI agents and connected devices.

pip install vaas-x gives any device or agent a persistent, queryable record of what it's seen -- what happened, what it did, what the outcome was -- and retrieves the closest matching past episode in milliseconds, on CPU, with no cloud round-trip required for the actual similarity search.

Install

pip install vaas-x

Get a free-tier API key at vaasx.com -- no card required.

Quickstart

from vaasx import Bootstrap

brain = Bootstrap(api_key="...", device_id="my_device")

# Point it at a structured data stream (sensor readings, agent actions,
# API events -- anything JSON-shaped) and it profiles the stream
# automatically, no schema design required.
brain.connect("https://your-data-stream.com/events")

# Query for the most similar past episodes, ranked by what actually
# worked, not just what's nearest in vector space.
hits = brain.query("engine running hot", k=5, prefer_success=True)

An agent that already knows its own outcome the moment it acts can log a full state/action/outcome episode in one call instead of a separate ingest-then-tag-later round trip:

resp = brain.ingest([{
    "state": {"observation": observation},
    "action": {"taken": action},
    "outcome": {"success": result.success},
}])
episode_id = resp["episode_ids"][0]

What it does

• Profiles a raw data stream automatically -- statistical profiling, schema classification, and anomaly detection all run locally before anything touches the network.
• Stores episodes as (state, action, outcome) triples, so retrieval can be weighted toward what worked last time in a similar situation, not just nearest by embedding distance.
• Runs on both a small edge device and a standard server -- same codebase, no domain-specific build.

Tiers

Free gets you an API key instantly. Developer and Professional are self-serve paid tiers with higher episode/query limits. Enterprise is contract-based, for teams wanting on-prem or air-gapped deployment. See vaasx.com/pricing for current details.

The honest caveat

This package ships as a compiled wheel, not source-available -- the retrieval and indexing internals are proprietary and protected as a trade secret, not through patent filing. What is open: full API documentation, working examples, and the wire format, so you can see exactly what goes in and comes back even without reading the internals.

Multimodal support (vision/audio/depth/thermal, via the optional ac extra) is real but still early -- encoder models are in active training and not yet production-tuned; treat it as a preview, not a finished feature.

Links

• Documentation
• Homepage

License

Proprietary -- see LICENSE.