face

A command-line application framework (and CLI parser). Friendly for users, full-featured for developers.

face License unclear Active ★ 24 v26.0.1 released 2026-06-17

Install

face on PyPI

pip

pip install face

uv

uv add face

poetry

poetry add face

Package facts

License	not declared (unclear)
Python support	supports the current Python release (>=3.10)
Install friction	low — pure-Python wheel
Runtime dependencies	1 — boltons
Maintenance	actively maintained — 57 days since the last release
Last repo commit	2026-08-03
First released	2018-02-19
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: face-26.0.1-py3-none-any.whl

Intended Audience :: DevelopersProgramming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: Implementation :: CPythonProgramming Language :: Python :: Implementation :: PyPyTopic :: Software Development :: LibrariesTopic :: Utilities

About face

from the package's own PyPI description — quoted content, verbatim

Face

Command-line parser and interface builder

Docs here.

Users

Read as markdown · JSON record · Source repository · Homepage · Docs

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

Face is a command-line application framework that simplifies building CLI tools with argument parsing and interface generation, designed to be user-friendly while offering full developer control.

Low friction: pure Python wheel, single lightweight dependency (boltons), and actively maintained with a recent release 57 days ago.

License status is unclear—no SPDX identifier or raw license text is recorded in the package metadata, so you should verify the actual license terms in the repository before adopting it.

Usage

pip install face

from face import Command

cmd = Command()
cmd.parser.add_argument('--name', default='World')

@cmd.main
def main(name):
    print(f'Hello, {name}!')

if __name__ == '__main__':
    cmd.execute()

Requires Python 3.10 or later.

Verdict: Face is a lightweight, actively maintained CLI framework suitable for building command-line tools with minimal dependencies. However, the unclear license status requires verification before production use—check the repository to confirm licensing terms align with your project.

Needs verification

What is the actual license of face? The package metadata does not declare one.
How does face compare in feature completeness to other CLI frameworks for typical use cases?

command line parser pythoncli argument parser frameworkcommand line interface builderpython cli tool frameworkargument parsing librarycommand line app frameworkcli interface generator