guacamole
Guacamole is an command line tool library for Python
Decision gist · record as of 2026-08-14
No. While the framework is lightweight and has no dependencies, it has been abandoned for over a decade with no maintenance or Python version updates. Modern alternatives like Click, Typer, or even argparse directly are actively maintained and better suited for new projects. Use Guacamole only if maintaining legacy code that already depends on it.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Project is abandoned; compatibility with Python versions after 2015 is unverified and likely problematic.
- Installation is straightforward with no runtime dependencies.
- However, the project is abandoned—last release was 2015-08-06 and last commit 2022-12-26—so expect no active maintenance or support for modern Python versions.
License · maintenance · safety
LGPLv3 (copyleft) — Licensed under LGPLv3 (copyleft), which requires derivative works to be licensed under the same terms and makes source code available to users who receive the software.
last release 2015-08-06 (4026 days) · last repo commit 2022-12-26 · 7 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 88,880 downloads/mo, #13,696 on PyPI
Alternatives
Verify before relying
pip install guacamole
import guacamole
class HelloWorld(guacamole.Command):
def register_arguments(self, parser):
parser.add_argument('name')
def invoked(self, ctx):
print("Hello {0}!".format(ctx.args.name))
HelloWorld().main(['Guacamole'], exit=False)- Whether the package works reliably with Python versions released after 2015
- Compatibility with modern argparse or whether it requires workarounds
- Active user base or community support despite abandonment status
What it is and what it does
Guacamole is a command-line application framework that abstracts away boilerplate setup tasks. Instead of manually configuring argument parsers, setting up logging, handling internationalization, and writing crash handlers, you define command classes that inherit from guacamole.Command, implement register_arguments() and invoked() methods, and call main() to run them. The framework handles argument parsing, logging initialization, i18n features, debugging facilities, and error handling automatically.
The package supports grouping commands into complex tools and uses a recipe-based customization system (recipes, ingredients, and spices) to modify behavior. It was originally part of plainbox and extracted into a standalone library. With zero runtime dependencies and a pure-Python wheel distribution, installation is frictionless, but the project has been abandoned since 2015 with no active maintenance.
Use it for
- Build a multi-command CLI tool (like git subcommands) without manually wiring argument parsers and dispatchers
- Create a simple command-line utility that needs logging, internationalization, and error handling out of the box
- Prototype command-line applications quickly by focusing on business logic rather than CLI infrastructure
- Organize related CLI commands into a single cohesive tool using the command grouping system
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
No.
While the framework is lightweight and has no dependencies, it has been abandoned for over a decade with no maintenance or Python version updates. Modern alternatives like Click, Typer, or even argparse directly are actively maintained and better suited for new projects. Use Guacamole only if maintaining legacy code that already depends on it.
Install
guacamole on PyPI
Before you install
Installation is straightforward with no runtime dependencies. However, the project is abandoned—last release was 2015-08-06 and last commit 2022-12-26—so expect no active maintenance or support for modern Python versions.
Project is abandoned; compatibility with Python versions after 2015 is unverified and likely problematic.
License in practice
Licensed under LGPLv3 (copyleft), which requires derivative works to be licensed under the same terms and makes source code available to users who receive the software.
Quickstart
pip install guacamole
import guacamole
class HelloWorld(guacamole.Command):
def register_arguments(self, parser):
parser.add_argument('name')
def invoked(self, ctx):
print("Hello {0}!".format(ctx.args.name))
HelloWorld().main(['Guacamole'], exit=False)Verify before relying
- Whether the package works reliably with Python versions released after 2015
- Compatibility with modern argparse or whether it requires workarounds
- Active user base or community support despite abandonment status
Package facts
| License | LGPLv3 copyleft |
| Python support | Not specified |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Abandoned 4,026 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 88,880 / month, #13,696 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 3 - AlphaEnvironment :: ConsoleIntended Audience :: DevelopersLicense :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)Natural Language :: EnglishNatural Language :: PolishOperating System :: MacOS :: MacOS XOperating System :: Microsoft :: Windows :: Windows 7Operating System :: Microsoft :: Windows :: Windows XPOperating System :: POSIXOperating System :: POSIX :: LinuxProgramming Language :: Python :: 2Programming Language :: Python :: 2.7Programming Language :: Python :: 3Programming Language :: Python :: 3.2Programming Language :: Python :: 3.3Programming Language :: Python :: 3.4Programming Language :: Python :: Implementation :: CPythonProgramming Language :: Python :: Implementation :: PyPyTopic :: Software DevelopmentTopic :: Software Development :: Libraries |
Evidence: guacamole-0.9.2-py2.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 › “command line argument handling”
- guacamoleGuacamole provides a framework for building command-line applications…
- argparse-extExtends Python's standard argparse module with additional…
- faceFace is a command-line application framework that builds CLI parsers…
Give your agent the search over MCP, or paste the wish link into any chat.
More Software Development packages
Provides backported and experimental type hints for Python 3.9+, allowing use of newer typing features on older Python versions and enabling early experimentation with type system PEPs before they enter the standard library.
NumPy provides an N-dimensional array object and a comprehensive suite of mathematical, linear algebra, Fourier transform, and random number functions for scientific computing in Python.
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Distlib provides low-level packaging utilities for building, distributing, and managing Python software—including metadata handling, version specifiers, wheel support, script installation, and dependency resolution.
See also argparse · decli · face · mando · argh · argparse-addons · argcomplete · autocommand · jaraco.logging · argparse-ext