Skip to main content

vaas-x

Episodic memory that persists, for AI agents and connected devices. It keeps what happened, what was done and how it turned out, and brings back what worked.

pip install vaas-x gives any device or agent a persistent, queryable record of what it has seen: what happened, what it did, what the outcome was. It 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 API key at vaasx.com: an email address, no card.

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 is 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]

Prefer no code? Use the connector

If you use Claude, Cursor, VS Code or another agent that supports MCP, you do not need this package. Add https://mcp.vaasx.com/mcp as a remote MCP server and the agent gets the same memory, with no key to paste. Whether an agent uses its memory without being asked depends on the agent. You can see and manage everything it remembers at app.vaasx.com (sign in with an emailed code).

What the connectors read

A web address, file, WebSocket or MQTT topic can hold more than numbers, and the SDK looks at each record before it decides what to do with it (the "scout"):

  • Numbers and true/false are profiled and classified as sensor channels, as before.
  • Text, descriptions, titles, timestamps, ids and nested values are kept with their values in a readable episode, so an agent that recalls it can read it. Long text is split into parts.
  • A web address can return JSON, an RSS or Atom feed, or a plain text or HTML page.
  • A record that repeats exactly, such as a feed polled again with no new stories, is stored once. A numeric reading is never skipped. Pass dedupe=False to connect() to turn this off.

Rate limits

The service limits how many requests one key can make in a minute (60 on Free, more on paid plans). When a request is refused for that reason, the SDK waits and tries again, for up to about a minute in total, before it raises an error. A request refused because your plan's note limit is full is never retried. Use Bootstrap(..., max_retries=0) to fail at once.

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.

When files stop being enough

If one agent on one machine is all you have, a markdown file is a fine place to start. A memory service earns its place when several agents need the same memory, when facts change mid-project, and when you want recall ranked by what worked. Every published result has a reproduction guide you can run yourself: vaasx.com/guides. Comparisons: Mem0, Supermemory, a vector database.

Tiers

Free gets you an API key instantly (10,000 episodes, 500 queries a day, 1 device). Personal (£9.99 a month) adds the app, 50,000 notes, unlimited searches and 3 devices. Developer and Professional are self-serve SDK tiers with higher episode and device 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.

License

Proprietary -- see LICENSE.

Metadata

Release files for vaas-x 0.1.15

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for vaas-x 0.1.15
File Actions
vaas_x-0.1.15-cp314-cp314-win_amd64.whl CPython 3.14 CPython 3.14 Windows x86-64 Details for vaas_x-0.1.15-cp314-cp314-win_amd64.whl
vaas_x-0.1.15-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl CPython 3.14 CPython 3.14 Linux glibc 2.28+ x86-64, Linux glibc 2.17+ x86-64 Details for vaas_x-0.1.15-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
vaas_x-0.1.15-cp313-cp313-win_amd64.whl CPython 3.13 CPython 3.13 Windows x86-64 Details for vaas_x-0.1.15-cp313-cp313-win_amd64.whl
vaas_x-0.1.15-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl CPython 3.13 CPython 3.13 Linux glibc 2.17+ x86-64, Linux glibc 2.28+ x86-64 Details for vaas_x-0.1.15-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
vaas_x-0.1.15-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl CPython 3.12 CPython 3.12 Linux glibc 2.28+ x86-64, Linux glibc 2.17+ x86-64 Details for vaas_x-0.1.15-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
vaas_x-0.1.15-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl CPython 3.11 CPython 3.11 Linux glibc 2.28+ x86-64, Linux glibc 2.17+ x86-64 Details for vaas_x-0.1.15-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
vaas_x-0.1.15-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl CPython 3.10 CPython 3.10 Linux glibc 2.28+ x86-64, Linux glibc 2.17+ x86-64 Details for vaas_x-0.1.15-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl

Total release size: 14.0 MB

Release files / vaas_x-0.1.15-cp314-cp314-win_amd64.whl

Download URL vaas_x-0.1.15-cp314-cp314-win_amd64.whl
Size 442.3 kB
Tags CPython 3.14 Windows x86-64
SHA-256 checksum
How to use checksums
9fa0a8ee51e248262a221d9601f87b9e1e8935abfae68fcc7670503f849b17c8
BLAKE2b-256 checksum
How to use checksums
2c776221a4762fb7e06f68b77c5775453fe84b9572547415ce4bb754a6e70737
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.3

Release files / vaas_x-0.1.15-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl

Download URL vaas_x-0.1.15-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Size 2.6 MB
Tags CPython 3.14 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
402aa6e6afa787d1aa296caf918c404e4bd83c4fb6b2db298636f3c268e851d6
BLAKE2b-256 checksum
How to use checksums
d2834a44fcc8340198459afcf587fb41659bbbc50daf8faf66343ebea8d8aba3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.3

Release files / vaas_x-0.1.15-cp313-cp313-win_amd64.whl

Download URL vaas_x-0.1.15-cp313-cp313-win_amd64.whl
Size 440.7 kB
Tags CPython 3.13 Windows x86-64
SHA-256 checksum
How to use checksums
e029ce32697c0192416a1ae09f7b28202a37e42780e3e1dddf8788c2c70165b4
BLAKE2b-256 checksum
How to use checksums
401cb7114f3f6a69dea29b6dd44fc216076c5292301bb73b072020d13371be87
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.3

Release files / vaas_x-0.1.15-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl

Download URL vaas_x-0.1.15-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Size 2.7 MB
Tags CPython 3.13 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
0e39be0f761f9c5c98c61b29bfdce3b96e2e5fc43e0feb0a76873693143f53ea
BLAKE2b-256 checksum
How to use checksums
6a1e488a0136e1380a969b43cfcd32f580920ec208b2a006193402d5c5f4e820
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.3

Release files / vaas_x-0.1.15-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl

Download URL vaas_x-0.1.15-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Size 2.7 MB
Tags CPython 3.12 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
92d91fc1861579c36919f7c345f136beae07369b672589ba0dd201c855e4570a
BLAKE2b-256 checksum
How to use checksums
6163f366a61e41bf5952315823dc0ff28478281fbe4b2c600cc4172bd8f47bb8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.3

Release files / vaas_x-0.1.15-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl

Download URL vaas_x-0.1.15-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Size 2.6 MB
Tags CPython 3.11 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
7d1b29fbe2b21c95cb558c0a69c90c68920baed974e091b7f652752a261858c9
BLAKE2b-256 checksum
How to use checksums
5499e6754af32a268b76d0980ddbc6d818c5eb02cb167cf703297dcdd2fb62ad
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.3

Release files / vaas_x-0.1.15-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl

Download URL vaas_x-0.1.15-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Size 2.5 MB
Tags CPython 3.10 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
e8522d759225065a29db719df41ba6425a280dd341d5e7818900ec7d10f382ca
BLAKE2b-256 checksum
How to use checksums
b3a6f200db7f770b6eb7d3d0584ac2641298d1a5c88f1d94d0ad670802d5f61d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.3

Security for vaas-x 0.1.15

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page