## What is BridgeRust? **BridgeRust** is a unified framework that lets you write your library once in Rust and automatically deploy native, high-performance bindings to both Python and Node.js. Stop juggling PyO3 and NAPI-RS. Stop maintaining multiple codebases. Write once, deploy everywhere with zero boilerplate. ## Why BridgeRust? ### ✨ Write Once, Deploy Everywhere ```rust use bridgerust::export; #[export] pub fn greet(name: String) -> String { format!("Hello, {}!", name) } #[export] pub struct Point { pub x: f64, pub y: f64, } ``` That's it. BridgeRust generates Python wheels and Node.js native addons automatically. ### 🚀 Zero Boilerplate No more manual PyModule or napi_register_module definitions. Just tag your code with #[export] and BridgeRust handles the rest. **Before**: 50+ lines of boilerplate **After**: One #[export] macro ### ⚡ Maximum Performance Your code runs at Rust speeds with minimal overhead. Zero-cost abstractions where possible, native performance everywhere. ### 🎯 Idiomatic APIs BridgeRust automatically handles naming conventions: - Rust's snake_case → Python's snake_case - Rust's snake_case → JavaScript's camelCase Your users get native-feeling APIs in every language. ## Quick Start ```bash # Install the CLI cargo install bridge # Initialize a new project bridge init my-awesome-lib # Write your Rust code with #[export] macros # Build for all platforms bridge build --all # Publish to PyPI and npm bridge publish ``` ## Key Features ✅ **Unified Macro System** - One #[export] macro for all languages ✅ **Automatic Type Conversions** - Vec, Option, Result handled automatically ✅ **Async Support** - Works with Python's asyncio and Node.js promises ✅ **Custom Types** - Your structs become classes in both languages ✅ **Integrated CLI** - Build, test, and publish with one command ✅ **Zero Boilerplate** - No manual binding code required ## Real-World Success **Embex** - A universal vector database ORM built with BridgeRust. One Rust codebase powers both Python (pip install embex) and Node.js (npm install @bridgerust/embex) packages. By using BridgeRust, we maintained a single codebase for connection pooling, SIMD operations, and retry strategies while offering native packages for both ecosystems. ## Perfect For - **Performance-Critical Libraries** - Math, cryptography, data processing - **Infrastructure Tools** - Database clients, network libraries, file systems - **AI/ML Libraries** - Vector operations, model inference, data pipelines - **Cross-Platform Tools** - Utilities that need to work in multiple ecosystems ## Benefits 🎯 **One Codebase** - Write once, maintain once 🎯 **Consistency** - Same features and bug fixes across all languages 🎯 **Performance** - Rust speed with zero-cost abstractions 🎯 **Developer Experience** - Simple CLI, zero boilerplate ## Resources - **GitHub**: [github.com/bridgerust/bridgerust](https://github.com/bridgerust/bridgerust) - **Documentation**: [bridgerust.dev](https://bridgerust.dev) - **CLI Crate**: [crates.io/crates/bridge](https://crates.io/crates/bridge) --- **Stop writing glue code. Start building bridges.**