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).

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.14

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.14
File Actions
vaas_x-0.1.14-cp314-cp314-win_amd64.whl CPython 3.14 CPython 3.14 Windows x86-64 Details for vaas_x-0.1.14-cp314-cp314-win_amd64.whl
vaas_x-0.1.14-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.14-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
vaas_x-0.1.14-cp313-cp313-win_amd64.whl CPython 3.13 CPython 3.13 Windows x86-64 Details for vaas_x-0.1.14-cp313-cp313-win_amd64.whl
vaas_x-0.1.14-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.14-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
vaas_x-0.1.14-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.14-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
vaas_x-0.1.14-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.14-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
vaas_x-0.1.14-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.17+ x86-64, Linux glibc 2.28+ x86-64 Details for vaas_x-0.1.14-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl

Total release size: 13.5 MB

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

Download URL vaas_x-0.1.14-cp314-cp314-win_amd64.whl
Size 418.9 kB
Tags CPython 3.14 Windows x86-64
SHA-256 checksum
How to use checksums
f9a9dd51d03da54948bf97fd440d2bb10afccd114181e716d371d2b13e1d3f5d
BLAKE2b-256 checksum
How to use checksums
acd5e7f49c20613375a9dd68983ba2132cff49245f633ba217c9d833675c5c00
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.14-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl

Download URL vaas_x-0.1.14-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Size 2.5 MB
Tags CPython 3.14 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
93c8a380e740ccfc46aca7912ac61f2db25991e448b281c4baa3e11a28a22aa2
BLAKE2b-256 checksum
How to use checksums
cc49be668f063b440047b751996ea9fe85f99bff9fb9b0459eab4254b9d75472
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.14-cp313-cp313-win_amd64.whl

Download URL vaas_x-0.1.14-cp313-cp313-win_amd64.whl
Size 417.7 kB
Tags CPython 3.13 Windows x86-64
SHA-256 checksum
How to use checksums
2faaa4f8f303d3221e8d3eb2f6e19a33190629be1cf035015845bbe88aa1e89f
BLAKE2b-256 checksum
How to use checksums
b0fb94180ac88a88e63af26df8d868d8e4e19e56c02235d263f2b0f1a368391e
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.14-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl

Download URL vaas_x-0.1.14-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Size 2.6 MB
Tags CPython 3.13 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
d434ef34780eedfc9dd1dbfe5c94507ed9ebeb6549aaa929bd948edf9bee7d32
BLAKE2b-256 checksum
How to use checksums
66ffb6d1b42d22b005a7178587207a240a9a3d3a80b819858956bd549e5922ab
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.14-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl

Download URL vaas_x-0.1.14-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Size 2.6 MB
Tags CPython 3.12 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
ae8a82fba14f1520a86e6f40d7735118332f780dd9bc0794b5ac6903e94a97c3
BLAKE2b-256 checksum
How to use checksums
61ec7b9fa1abe23047c0e98b91e516dd890937998e7d4bb69a2d87253e32a832
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.14-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl

Download URL vaas_x-0.1.14-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Size 2.5 MB
Tags CPython 3.11 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
537ce2b181f58a7278a33fcdeb86c96a28de58a4429808ad3e868066c434a24e
BLAKE2b-256 checksum
How to use checksums
9e1850552f43becdf29b5c238795fb463cdd8f587f67208d71af3824726ffbf6
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.14-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl

Download URL vaas_x-0.1.14-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Size 2.4 MB
Tags CPython 3.10 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
eb213ff26d59344a33dfc56e0feb129344b21359e4815e4ea4b18d8e5317d4f9
BLAKE2b-256 checksum
How to use checksums
1da9767a5766c7c612a646c87b9c3e69aed24f6614101a72e8ac92fe228b6d63
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.14

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