This repository is the complete OmniPulse monorepo.

All four modules live here and ship to PyPI and crates.io independently.
This root lets you read the architecture in one place and jump to
whichever sub-package you need. See https://github.com/samvardhan03/Omnipulse.

Engineering outcomes (the headline numbers)

These are the operating points the architecture optimizes for. The
underlying math (analytic Morlet wavelet scattering, sliced
1-Wasserstein on empirical fingerprint distributions, HNSW indexing) is
explained in depth inside the per-module READMEs — this root keeps
the lens on engineering outcomes.

Architecture at a glance

                         ┌──────────────────────────────────────────────┐
                         │   omnipulse-agent  (PyPI · Python 3.11+)    │
                         │   ──────────────────────────────────────    │
                         │   • Anthropic-driven cognitive router        │
                         │   • SharedMemoryManager (POSIX shm)          │
                         │   • MCPClient — line-delimited JSON-RPC 2.0  │
                         └────────────────────┬─────────────────────────┘
                                              │
                       28-char hex shm name   │   stdio pipes
                       (SHA3-256 digest[:14]) │   (one \n-terminated frame per call)
                                              ▼
                         ┌──────────────────────────────────────────────┐
                         │   omnipulse-rs  (crates.io · Rust workspace) │
                         │   ──────────────────────────────────────    │
                         │   • omnipulse-mcp binary  (rmcp stdio)       │
                         │   • vector-index  (concurrent HNSW)          │
                         │   • sliced-wasserstein  (SW₁ metric)         │
                         │   • shm_open + mmap + spawn_blocking         │
                         └────────────────────┬─────────────────────────┘
                                              │
                       u64 pinned-host ptr    │   cxx::bridge (zero-marshalling)
                       (UVA-registered page)  │
                                              ▼
                         ┌──────────────────────────────────────────────┐
                         │   omni-ffi  (crates.io · zero-copy bridge)   │
                         │   ──────────────────────────────────────    │
                         │   • cxx 1.0 — unsafe extern "C++"             │
                         │   • CPU path: cpp/wst_bridge_cpu.cpp          │
                         │   • CUDA path: cpp/wst_bridge_cuda.cpp        │
                         │     (links cudart + cufft)                    │
                         └────────────────────┬─────────────────────────┘
                                              │
                       raw float* / CUdeviceptr│
                                              ▼
                         ┌──────────────────────────────────────────────┐
                         │   omni-wst-core  (PyPI · C++/CUDA wheels)    │
                         │   ──────────────────────────────────────    │
                         │   • WSTEngine<HopperTag, J, Q>   (CUDA)       │
                         │   • build_cpu_morlet_bank + Radix-2 FFT (CPU) │
                         │   • Plasma cudaHostRegister                   │
                         └──────────────────────────────────────────────┘

Every arrow is one of: a 28-char shm name, a \n-terminated JSON
frame, a raw u64 pointer, or a registered host page. No protobuf,
no gRPC, no HTTP, no JSON-over-network. That is the design.

Modules — where each package lives

If you want the end-to-end demo, install both Python packages and
the Rust binary in the same environment, set ANTHROPIC_API_KEY, and
run python -m omnipulse_agent.run --wav your.wav.

Try it (≈ 90 seconds)

# 1. The math engine (PyPI wheel — C++/CUDA inside)
pip install omni-wst-core

# 2. The Rust MCP orchestrator binary
cargo install omnipulse-mcp

# 3. The Python control plane (agentic layer)
pip install omnipulse-agent

# 4. Run the demo
export ANTHROPIC_API_KEY=sk-ant-...
python -m omnipulse_agent.run --wav your.wav

You will see the four-stage trace: ingest → shm pin → cxx bridge →
HNSW insert, with the 28-char SHA3 hex shm name printed at each
boundary.

Repository layout (this showcase)

.
├── README.md                                ← you are here
├── omni-wst-core/                           ← C++/CUDA DSP engine
├── omni-ffi/                                ← cxx zero-copy FFI bridge
├── omnipulse-rs/                            ← Rust workspace (vector-index, sliced-wasserstein, omnipulse-mcp)
├── omnipulse-agent/                         ← Python agentic control plane
└── site/                                    ← Next.js marketing site (omnipulse.dev)

The vendored snapshots are kept for reading only. They lag the
canonical per-module repos slightly. Always clone the per-module repo
if you intend to build or contribute.

Maintainers

• Samvardhan Singh — C++/CUDA DSP engine (omni-wst-core), the cxx FFI bridge (omni-ffi), and the PyPI agentic control plane (omnipulse-agent). Focus: automation engineering, AI/MLOps pipelines, engineering outcomes. samvardhan.vercel.app · [email protected]
• Yash Mishra — Rust crates (vector-index, sliced-wasserstein). Focus: concurrent systems, optimal transport, real-time indexing. linkedin.com/in/mishra-yash2002 · [email protected]
• Phase 3 — Autonomous Agentic Control Plane is co-authored by Samvardhan and Yash.

License

Apache 2.0 for all open source modules. A commercial license tier
exists for production deployments at scale — see
omnipulse.dev/licensing or email
[email protected].