Skip to content

Installation

Requirements

  • Python 3.10+
  • Rust 1.75+ (for building from source)

Install from PyPI

pip install oxyde

Install from Source

If you need to build from source (e.g., for development or customization):

1. Clone the Repository

git clone https://github.com/mr-fatalyst/oxyde.git
cd oxyde

2. Create Virtual Environment

python -m venv .venv
source .venv/bin/activate  # Linux/macOS
# or
.venv\Scripts\activate     # Windows

3. Build Rust Core

# Build the Rust workspace
cargo build --release

# Install the Python extension (PyO3 bindings)
cd crates/oxyde-core-py
pip install maturin
maturin develop --release

4. Install Python Package

cd ../../python
pip install -e .

Verify Installation

import oxyde
print(oxyde.__version__)

Database Drivers

Oxyde uses SQLx under the hood. Database drivers are included — no additional installation required.

Database Connection URL
PostgreSQL postgresql://user:pass@host:5432/db
SQLite sqlite:///path/to/file.db or sqlite:///:memory:
MySQL mysql://user:pass@host:3306/db

Next Steps