honcho

library2.0.0pypypi✓ verified 22d ago

Honcho is a Python port of David Dollar's Foreman, a command-line application that helps you manage and run Procfile-based applications. It simplifies deployment and configuration in development and production by running multiple external processes and multiplexing their output. The current version is 2.0.0, with releases occurring infrequently but actively maintained.

devops

pip install honcho

github ↗package ↗

INSTALL

IMPORT

SIG · HONCHO

honcho

devopspythonv2.0.0

Install

1.6s avg

Import

—

Disk

16MB

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.0.0 · 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 · 18MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 1.6s · import 0.000s · 18MB

16MB installed

● package 16MB

Code

Verified usage

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

Procfile

✓ from honcho import Procfile

✗ from honcho import Procfile

Create a Procfile to define your application's processes (e.g., a simple web server) and then use `honcho start` to run them. Honcho will automatically read the `Procfile` in the current directory and assign a port.

echo 'web: python -m http.server $PORT' > Procfile honcho start

honcho --version

Debug

Known issues

breakingVersion 2.0.0 dropped support for Python 3.6, 3.7 and PyPy 3.7, 3.8. It now supports Python 3.11, 3.12, 3.13 and PyPy 3.9, 3.10.

fix

Upgrade to a supported Python or PyPy version (3.11+ for CPython, 3.9+ for PyPy).

affects: >=2.0.0

gotchaBe careful not to confuse `honcho` (Procfile manager) with `honcho-ai` (an unrelated AI conversational memory platform SDK). Ensure you install `honcho` from PyPI for Procfile management.

fix

Always verify the package name when installing: `pip install honcho`.

affects: all

gotchaThe `honcho run` command is designed to execute arbitrary shell commands within the environment provided by Honcho and `.env` files. It does not accept Procfile-defined process targets. For running Procfile-defined processes, use `honcho start`.

fix

Use `honcho start` to run processes defined in your Procfile. Use `honcho run <command>` for ad-hoc commands.

affects: all

gotchaWhen using command-line arguments like `-f` (to specify a Procfile path), ensure they are placed *before* the subcommand (e.g., `start`, `run`) to be correctly parsed. Historically, placing them after the subcommand could lead to them being ignored in older versions.

fix

Always place global options before the subcommand: `honcho -f Procfile.dev start`.

affects: <=0.7.0, all

gotchaThe `PROCFILE` environment variable in Honcho 2.0.0 configures the *name* of the Procfile (e.g., 'Procfile.dev'), not necessarily its full path, if you intend to override the default `Procfile` lookup behavior. While older versions mentioned specifying location, the intent is for filename overrides.

fix

To specify a Procfile path, use the `-f` command-line argument: `honcho -f /path/to/Procfile start`. The `PROCFILE` environment variable should typically specify a filename.

affects: >=2.0.0

Upgrade

Version history

2.0.0latest on PyPI · released Oct 6, 2024

Audit

Dependencies

No dependency data recorded yet.

Agent activity

28 hits · last 30 days

node

Resources

githubhttps://github.com/nickstenning/honcho ↗

packagehttps://pypi.org/project/honcho/ ↗