Praxis documentationv0.7.2 · Guide

Extend and contribute

Use Rust when you need custom filters, protocols, or changes to the Praxis project.

Running Praxis and configuring its built-in behavior do not require Rust. This path is for developers who need behavior that the selected binary does not provide, want to write an extension, or plan to contribute to a project.

Tutorial: write a filter

Follow the custom HTTP filter tutorial (Praxis v0.7.2) to implement behavior in Rust and build a proxy with that filter.

How-to: add behavior and contribute

Add a built-in filter (Praxis v0.7.2) or add a protocol (Praxis v0.7.2) to Praxis itself. To contribute a change, use the development setup and test commands (Praxis v0.7.2), then read contribution conventions (Praxis v0.7.2) and dependency guidance (Praxis v0.7.2). Project proposals are tracked in the enhancements repository.

Reference: extension interfaces

The filter extension reference (Praxis v0.7.2) describes extension interfaces and registration. Pair it with the built-in filter reference (Praxis v0.7.2) for the types and configuration available in the selected release.

Explanation: runtime and crate design

Pipeline concepts (Praxis v0.7.2) explains how configured chains form a request pipeline; the crate layout (Praxis v0.7.2) describes where runtime and extension interfaces live.

For AI-specific filters, build and develop in the independently versioned Praxis AI project: AI development setup (Praxis AI v0.5.0 (alpha)) and adding an AI filter (Praxis AI v0.5.0 (alpha)).

See the operator path for configuration tasks that do not need custom Rust code.