Metadata-Version: 2.4
Name: wombatkv
Version: 0.0.0
Summary: Placeholder reservation for the wombatkv Python bindings. Real bindings ship in a future release; see https://crates.io/crates/wombatkv-node.
Author-email: Venkat Raman <vraman2811@gmail.com>
Maintainer-email: Venkat Raman <vraman2811@gmail.com>
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/Venkat2811/wombatkv
Project-URL: Repository, https://github.com/Venkat2811/wombatkv
Project-URL: Issues, https://github.com/Venkat2811/wombatkv/issues
Project-URL: Twitter, https://twitter.com/venkat_systems
Keywords: placeholder,kv-cache,llm,inference,object-storage,s3,prefix-cache,caching,rust
Classifier: Development Status :: 1 - Planning
Classifier: Intended Audience :: Developers
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Rust
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: System :: Distributed Computing
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# wombatkv (Python placeholder)

This package is a **placeholder reservation** on PyPI for the future Python bindings of [`wombatkv`](https://github.com/Venkat2811/wombatkv). It does not provide any functionality yet.

## What `wombatkv` is

`wombatkv` is an object-storage-native KV cache system for LLM inference. It makes KV cache a shared, addressable resource: anything an engine prefills once (system prompts, RAG context, shared documents, conversation history) lands in an S3 bucket as content-addressed blocks. Any other engine pointing at the same bucket inherits it: the next process, the next conversation, the next agent in a fan-out, the next teammate on a different laptop.

The implementation is a Rust workspace at <https://github.com/Venkat2811/wombatkv>.

## Status

| Version | Status |
|---|---|
| `0.0.0` (this release) | Placeholder. No bindings. |
| `0.1.0+` | Real Python bindings (planned). Not yet released. |

Importing the package or accessing any attribute is currently a no-op pointing back to the upstream Rust crates.

## Rust crates (published on crates.io)

- [`wombatkv-node`](https://crates.io/crates/wombatkv-node), high-level Rust API
- [`wombatkv-cabi`](https://crates.io/crates/wombatkv-cabi), C ABI surface for non-Rust engines (`libwombatkv.{so,dylib}` + `wombatkv.h`)
- [`wombatkv-daemon`](https://crates.io/crates/wombatkv-daemon), sidecar deployment binary

## License

Apache License, Version 2.0. See [LICENSE](LICENSE).

## Links

- Rust source repository: <https://github.com/Venkat2811/wombatkv>
- Issues / questions: <https://github.com/Venkat2811/wombatkv/issues>
- Maintainer on Twitter/X: [@venkat_systems](https://twitter.com/venkat_systems)
