Registry / web-framework / django-viewflow

django-viewflow

library2.2.15pypypiunverified

A reusable library to build business applications fast, providing a BPMN-like workflow engine for Django. Current version is 2.2.15, with a release cadence of minor releases every few months.

web-framework workflow database

pip install django-viewflow

package ↗homepage ↗

INSTALL

IMPORT

SIG · DJANGO-VIEWFLOW

django-viewflow

web-frameworkpythonv2.2.15

Install

4.0s avg

Import

—

Disk

105MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v2.2.15 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 105.7MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 4.0s · import 0.000s · 106MB

105MB installed

● package 105MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Flow

✓ from viewflow import Flow

✗ from viewflow import Flow

Minimal flow definition with start and end nodes.

from viewflow.flow import Flow, Start, End, If from viewflow.base import this class MyFlow(Flow): start = Start().Next(this.end) end = End() # In views, you can activate process instances: from viewflow.models import Process # Example: act = MyFlow.start.run() # creates a process instance

Debug

Known issues

breakingViewflow v2.x is a complete rewrite from v1.x. The entire API changed; custom code from v1.x will not work.

fix

Upgrade to v2.x requires rewriting flow definitions. Refer to migration docs at https://github.com/viewflow/viewflow#migration-from-v1

affects: >=2.0.0

gotchaImport paths changed in v2: nodes like Start, End, If are now under viewflow.flow, not viewflow.nodes.

fix

Use 'from viewflow.flow import Start, End, If' instead of old import.

affects: >=2.0.0

deprecatedThe 'viewflow.workflow' module is deprecated; use 'viewflow.flow' instead.

fix

Replace 'from viewflow.workflow import ...' with 'from viewflow.flow import ...'

affects: >=2.1.0

Upgrade

Version history

2.2.15latest on PyPI · released Dec 24, 2025

Audit

Dependencies

djangorequiredCore dependency for the web framework

Agent activity

24 hits · last 30 days

node

Anthropic

OpenAI (training)

Resources

packagehttps://pypi.org/project/django-viewflow/ ↗

homepagehttps://viewflow.io ↗