Skip to main content

Installation

info

Fluvius Framework requires Python 3.12 or higher.

Prerequisites​

Before installing Fluvius Framework, ensure you have:

  • Python 3.12 or higher
  • pip or uv package manager
  • PostgreSQL, SQLite, or MongoDB (depending on your data driver choice)

Install from PyPI​

pip install fluvius

Install from Source​

Clone the repository and install in development mode:

git clone https://github.com/fluvius-io/fluvius-py.git
cd fluvius-py
pip install -e .

Install with uv​

If you're using uv for faster package management:

uv pip install fluvius

Verify Installation​

Verify that Fluvius is installed correctly:

import fluvius
print(fluvius.__version__)

Development Dependencies​

For development and testing, install with dev dependencies:

pip install -e ".[dev]"

This includes:

  • pytest and pytest-asyncio for testing
  • pyinstrument for profiling
  • ruff for linting

Next Steps​

Once installed, check out the Quick Start Guide to build your first Fluvius application.