selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

pneumaticworkflow logo

Self-host pneumaticworkflow

v7.3.2

AI-powered workflow automation with human-in-the-loop

ReleaseOpen SourceApache-2.0
Updated9 hours ago
LanguagePython
Setup difficultyAdvanced
Stars
319
RAM
8GB (recommended 16GB)
Storage
50GB (recommended 100GB)
Ports
80 (HTTP frontend via nginx), 443 (HTTPS frontend via nginx), 8001 (Backend API (also proxied via nginx))
Requires
PostgreSQL, RabbitMQ, Redis
Docker
pneumaticworkflow/pneumatic-backend
Install with Docker Compose
Workflow Templates screen showing template creation interfaceMulti-Workflow Management screen showing multiple running workflowsTask Buckets screen showing personal task list for a staff memberAutomated Workflow Tracking screen showing workflow progress visualization

What is pneumaticworkflow?

Pneumatic is a workflow management system that lets teams design, run, and optimize business processes through reusable templates. Users create workflow templates defining steps, assignees, deadlines, and conditional logic, then launch multiple workflow instances from each template. Each team member gets a personal task bucket to work through efficiently. The platform includes an AI-powered workflow builder that generates templates from natural language descriptions, shareable kick-off forms for external participants, guest performer access, urgent prioritization, workflow variables for data passing, video embeds in tasks, activity highlights, dashboards, comments with mentions, and a WYSIWYG editor. It runs via Docker Compose with PostgreSQL, Redis, RabbitMQ, and nginx, exposing ports 80, 443, and 8001. The self-hosted edition supports SSO via Okta or Auth0, OAuth via Google and Microsoft, and configurable email providers. A free cloud tier offers unlimited users and workflows; enterprise engagements add on-premise deployment, custom integrations, SLAs, private code branches, and dedicated support. Licensed Apache 2.0.

Should you self-host pneumaticworkflow?

pneumaticworkflow scores 48/100 on selfhost.directory (how scoring works) and ranks #19 of 32 in Workflow Automation. It has 319 GitHub stars.

It shipped 18 stable releases in the past year. The latest, v7.3.2, came out on 1 October 2026. New versions land roughly every 7 days.

Setup is advanced: plan for several services and some ongoing maintenance. An official Docker image is available. It is Apache-2.0-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is Leantime (74/100, 11 917 stars). It scores higher overall, so compare the two before you pick. See pneumaticworkflow vs Leantime side by side.

Features

  • Activity Highlights
  • AI-Powered Workflow Builder
  • Automated Workflow Tracking
  • Comments and mentions
  • Conditional Workflow Logic
  • Dashboards
  • Guest Performers
  • Multi-Workflow Management
  • Shareable Kick-off Forms
  • Task Buckets
  • Urgent Prioritization
  • Video Embeds in Tasks
  • Workflow Templates
  • Workflow Variables
  • WYSIWYG Editor

pneumaticworkflow README

How to install pneumaticworkflow

Install pneumaticworkflow with Docker Compose

Environment variables
SERVER_ADDRESS, BACKEND_URL, FRONTEND_URL, FORMS_URL, WSS_URL, POSTGRES_PASSWORD, POSTGRES_REPLICA_PASSWORD, REDIS_PASSWORD, RABBITMQ_PASSWORD, WORKERS_COUNT, SSO_AUTH, SSO_PROVIDER, OKTA_DOMAIN, OKTA_CLIENT_ID, OKTA_CLIENT_SECRET, OKTA_REDIRECT_URI, AUTH0_CLIENT_ID, AUTH0_CLIENT_SECRET, AUTH0_DOMAIN, AUTH0_REDIRECT_URI, GOOGLE_AUTH, GOOGLE_OAUTH2_CLIENT_ID, GOOGLE_OAUTH2_CLIENT_SECRET, GOOGLE_OAUTH2_REDIRECT_URI, MS_AUTH, MS_CLIENT_ID, MS_CLIENT_SECRET, MS_AUTHORITY, EMAIL, EMAIL_PROVIDER, AI, AI_PROVIDER, OPENAI_API_KEY, LANGUAGE_CODE, DJANGO_SECRET_KEY, FILE_STORAGE_TYPE, CAPTCHA, RECAPTCHA_SITE_KEY, RECAPTCHA_SECRET_KEY, SENTRY_DSN, PUSH, PUSH_PROVIDER, BILLING, STRIPE_SECRET_KEY, ANALYTICS, ANALYTICS_WRITE_KEY, and many more

git clone https://github.com/pneumaticapp/pneumaticworkflow.git cd pneumaticworkflow

Create .env file with required variables (SERVER_ADDRESS, BACKEND_URL, FRONTEND_URL, FORMS_URL, WSS_URL)

docker compose up -d

Requires Docker 2.27+ and Docker Compose 27.0+; at least 8GB RAM (16GB recommended), 50GB disk (100GB recommended); ports 80, 443, 8001 must be free

How to configure pneumaticworkflow

  • AInoEnable AI features

    Enable AI features

    values: yes, no

  • AI_PROVIDERAI provider

    AI provider

  • ANALYTICSnoEnable analytics

    Enable analytics

    values: yes, no

  • ANALYTICS_WRITE_KEYAnalytics write key

    Analytics write key

  • AUTH0_CLIENT_IDAuth0 client ID

    Auth0 client ID

  • AUTH0_CLIENT_SECRETAuth0 client secret

    Auth0 client secret

  • AUTH0_DOMAINAuth0 domain

    Auth0 domain

  • AUTH0_REDIRECT_URIAuth0 redirect URI

    Auth0 redirect URI

  • BACKEND_URLhttp://localhost:8001Backend API URL

    Backend API URL

  • BILLINGnoEnable billing features

    Enable billing features

    values: yes, no

  • CAPTCHAnoEnable CAPTCHA

    Enable CAPTCHA

    values: yes, no

  • DJANGO_SECRET_KEYdjango_secret_django_secret_django_secretDjango secret key

    Django secret key

  • EMAILnoEnable email sending

    Enable email sending

    values: yes, no

  • EMAIL_PROVIDEREmail provider (e.g., customerio)

    Email provider (e.g., customerio)

  • FILE_STORAGE_TYPElocalFile storage backend

    File storage backend

    values: local, seaweedfs, gcs

  • FORMS_URLhttp://localhost/formsForms service URL

    Forms service URL

  • FRONTEND_URLhttp://localhostFrontend URL

    Frontend URL

  • GOOGLE_AUTHnoEnable Google OAuth

    Enable Google OAuth

    values: yes, no

  • GOOGLE_OAUTH2_CLIENT_IDGoogle OAuth client ID

    Google OAuth client ID

  • GOOGLE_OAUTH2_CLIENT_SECRETGoogle OAuth client secret

    Google OAuth client secret

  • GOOGLE_OAUTH2_REDIRECT_URIGoogle OAuth redirect URI

    Google OAuth redirect URI

  • LANGUAGE_CODEenInterface language

    Interface language

    values: en, fr, de, es, ru

  • MS_AUTHnoEnable Microsoft OAuth

    Enable Microsoft OAuth

    values: yes, no

  • MS_AUTHORITYMicrosoft OAuth authority

    Microsoft OAuth authority

  • MS_CLIENT_IDMicrosoft OAuth client ID

    Microsoft OAuth client ID

  • MS_CLIENT_SECRETMicrosoft OAuth client secret

    Microsoft OAuth client secret

  • OKTA_CLIENT_IDOkta client ID

    Okta client ID

  • OKTA_CLIENT_SECRETOkta client secret

    Okta client secret

  • OKTA_DOMAINOkta domain

    Okta domain

  • OKTA_REDIRECT_URIOkta redirect URI

    Okta redirect URI

  • OPENAI_API_KEYOpenAI API key

    OpenAI API key

  • POSTGRES_PASSWORDpostgres_passwordPostgreSQL password

    PostgreSQL password

  • POSTGRES_REPLICA_PASSWORDpostgres_passwordPostgreSQL replica password

    PostgreSQL replica password

  • PUSHnoEnable push notifications

    Enable push notifications

    values: yes, no

  • PUSH_PROVIDERPush notification provider

    Push notification provider

  • RABBITMQ_PASSWORDrabbitmq_passwordRabbitMQ password

    RabbitMQ password

  • RECAPTCHA_SECRET_KEYreCAPTCHA secret key

    reCAPTCHA secret key

  • RECAPTCHA_SITE_KEYreCAPTCHA site key

    reCAPTCHA site key

  • REDIS_PASSWORDredis_passwordRedis password

    Redis password

  • SENTRY_DSNSentry DSN for error tracking

    Sentry DSN for error tracking

  • SERVER_ADDRESSlocalhostDomain name or IP address of the server

    Domain name or IP address of the server

  • SSO_AUTHnoEnable SSO authentication

    Enable SSO authentication

    values: yes, no

  • SSO_PROVIDERSSO provider (okta or auth0)

    SSO provider (okta or auth0)

    values: okta, auth0

  • STRIPE_SECRET_KEYStripe secret key

    Stripe secret key

  • WORKERS_COUNT2Number of gunicorn workers (each ~250MB RAM)

    Number of gunicorn workers (each ~250MB RAM)

  • WSS_URLws://localhost:8001WebSocket URL for real-time updates

    WebSocket URL for real-time updates

pneumaticworkflow releases & version history

FAQ

How does human-in-the-loop work?

Workflows alternate between AI tasks (processing data, generating summaries, making recommendations) and human tasks (review, approve, escalate). Each step has full audit trail and conditional logic.

What AI models do you support?

Pneumatic integrates with any OpenAI-compatible API including local LLM deployments, Azure OpenAI, Anthropic, and other providers. Custom ML pipelines and internal AI services are also supported.

Do you support on-premise deployment?

Yes, Pneumatic can be deployed on your own servers, private cloud, or any infrastructure. The core engine is open source (Apache 2.0) so your team can audit the code before deployment.

Can I start with Free and upgrade to Enterprise later?

Yes, many customers start with Free to explore the platform, then engage the Enterprise team when ready for custom AI workflows or on-premise deployment. Data and workflows transfer seamlessly.

What's included in the Enterprise engagement?

A dedicated implementation team handles process discovery, workflow design, custom integrations, LLM connectivity, on-premise deployment, team training, and ongoing support. Typical go-live in 4-8 weeks.

Is the Free plan really free forever?

Yes, the Free plan has no time limits, no credit card required, and no per-user charges. Unlimited users and workflows on the managed cloud.

More in AI Automation

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…