frappe-bench
CLI to manage Multi-tenant deployments for Frappe apps
Decision gist · record as of 2026-08-14
Yes. Bench is production-stable (Development Status 5), actively maintained, has no known vulnerabilities, and low installation friction. It is essential if you work with Frappe applications; optional if you do not. The copyleft license is standard for Frappe ecosystem tools and poses no barrier to use, only to redistribution of modifications.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later and Unix-like system (Linux, macOS); Windows is not supported.
- Low friction installation with a stable, actively maintained codebase.
- Last commit on 2026-08-11 and 1720 repository stars indicate ongoing development.
License · maintenance · safety
GPL-3.0-only (copyleft) — Licensed under GPL-3.0-only (copyleft). Any modifications or derivative works must be distributed under the same license; proprietary use of modified versions is not permitted.
last release 2026-06-16 (59 days) · last repo commit 2026-08-11 · 1,720 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 660,701 downloads/mo, #5,457 on PyPI
Alternatives
Verify before relying
pip install frappe-bench
bench --version
bench init my-bench
cd my-bench
bench new-site mysite.local- Whether Docker is required for all use cases or only for containerized deployment paths.
- Specific version compatibility with Frappe framework versions beyond the general 'latest stable' reference.
- Performance or scalability limits when managing large numbers of sites on a single bench instance.
What it is and what it does
Bench is a command-line utility designed to simplify the setup and management of Frappe application deployments. It handles the full lifecycle of Frappe sites—initialization of new benches, creation and installation of apps, site management, and backup operations—across Unix-like systems. The tool is built on top of common Python utilities (click for CLI, gitpython for version control, honcho for process management, jinja2 for templating) and supports both development and production environments. It can work with manual installation or Docker-based containerized setups, and includes an easy-install script for rapid deployment with minimal manual intervention.
Bench is primarily used by developers and operators working with the Frappe framework and applications built on it (such as ERPNext). The tool abstracts away much of the complexity of managing multiple sites and their dependencies, making it easier to maintain consistent environments across development and production. It is actively maintained, production-stable, and has a substantial user base reflected in its download volume and repository activity.
Use it for
- Initialize a new development bench and create multiple Frappe sites for local testing and feature development.
- Deploy and manage production Frappe instances using Docker containers with automated backup scheduling.
- Install and update custom Frappe applications across multiple sites without manual configuration.
- Manage site backups and perform version upgrades across a bench with a single command.
- Set up a complete ERPNext or other Frappe-based application stack using the easy-install script.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
Bench is production-stable (Development Status 5), actively maintained, has no known vulnerabilities, and low installation friction. It is essential if you work with Frappe applications; optional if you do not. The copyleft license is standard for Frappe ecosystem tools and poses no barrier to use, only to redistribution of modifications.
Install
frappe-bench on PyPI
Before you install
Low friction installation with a stable, actively maintained codebase. Last commit on 2026-08-11 and 1720 repository stars indicate ongoing development. Ten runtime dependencies are all widely-used utilities (click, gitpython, honcho, jinja2, requests, etc.), suggesting a mature dependency chain.
Requires Python 3.10 or later and Unix-like system (Linux, macOS); Windows is not supported.
License in practice
Licensed under GPL-3.0-only (copyleft). Any modifications or derivative works must be distributed under the same license; proprietary use of modified versions is not permitted.
Quickstart
pip install frappe-bench
bench --version
bench init my-bench
cd my-bench
bench new-site mysite.localVerify before relying
- Whether Docker is required for all use cases or only for containerized deployment paths.
- Specific version compatibility with Frappe framework versions beyond the general 'latest stable' reference.
- Performance or scalability limits when managing large numbers of sites on a single bench instance.
Package facts
| License | GPL-3.0-only copyleft |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 10 packagesclickgitpythonhonchojinja2python-crontabrequestssemantic-versionsetuptoolstomliuv |
| Maintenance | Actively maintained 59 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 660,701 / month, #5,457 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableEnvironment :: ConsoleLicense :: OSI Approved :: GNU General Public License v3 (GPLv3)Natural Language :: EnglishOperating System :: MacOSOperating System :: OS IndependentTopic :: Software Development :: Build ToolsTopic :: Software Development :: User InterfacesTopic :: System :: Installation/Setup |
Evidence: frappe_bench-5.31.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “frappe site management cli”
- frappe-benchBench is a CLI tool for installing, updating, and managing multiple…
- requires.ioA command-line tool and Python API client for interacting with the…
- doppler-envInjects Doppler secrets as environment variables into Python…
Give your agent the search over MCP, or paste the wish link into any chat.
More Build Tools packages
Provides reusable utilities for Python packaging interoperability, including version handling, specifiers, markers, requirements, tags, and metadata parsing according to standards like PEP 440 and PEP 425.
Wraps any iterable to display a real-time progress bar in the terminal or Jupyter notebook, showing iteration count, elapsed time, and estimated time remaining.
pip is the standard installer for Python packages, enabling you to download and install packages from the Python Package Index and other indexes into your Python environment.
Hatchling is a standards-compliant Python build backend that handles packaging, metadata, and distribution of Python projects when configured in a project's pyproject.toml file.
Generates Python gRPC service stubs and message classes from Protocol Buffer definitions, enabling developers to build gRPC clients and servers.
pre-commit is a framework for installing and running git hooks written in any language before commits are made, automating code quality and validation checks across multi-language projects.
Install it if your team needs consistent, automated validation at commit time.
See also fastapi-cloud-cli · flet-cli · s3cmd · reflex-hosting-cli · tower · gallery-dl · clickhouse-migrations · docker-compose · ecs-deploy · snowflake-cli