# facebookarchive/python-nubia

A command-line and interactive shell framework.

Repository: https://github.com/facebookarchive/python-nubia
Canonical: https://ross.abutalabs.com/products/python-nubia
Language: Python
License: NOASSERTION
License Family: other
Archived: true
Last push: 2022-05-30T15:02:35+00:00

## Health v2 (maintenance only)
Score: 10/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 2920, "days_push": 1556, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, archived, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1577, forks 96 (observed 2026-08-28T04:05:06.064663+00:00)

## What it is
Nubia is a lightweight Python framework for building command-line applications and interactive shells, built on top of python-prompt-toolkit. It generates CLI commands from Python functions and classes with type-annotation-based validation and offers fish-style auto-completion in interactive mode.

## Use cases
- build a python cli application with minimal boilerplate
- create an interactive shell for my tool with auto-completion
- generate cli commands from python functions and classes
- add bash/zsh completions to a command-line tool
- validate cli arguments using python type annotations
- build a custom interactive shell like ldshell

## When to choose
- you need both a CLI mode and an interactive shell from one codebase
- you want automatic command/argument completion with little effort
- you want type-annotation-driven argument validation in Python

## When to avoid
- you need a maintained framework - the project is archived and unmaintained
- you only need a simple argument parser (use argparse, click, or typer instead)
- you need guaranteed stability outside the original ldshell-style use case

## Facets
- artifact type: framework
- maturity: abandoned
- function: cli, developer-tools
- domain: developer-tools
- platform: python, cli, cross-platform
- tags: interactive-shell, command-line-framework, archived, prompt-toolkit, autocompletion, command-line

## Member repositories
- facebookarchive/python-nubia (main) score 10

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:06.064663+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:57:02.866114+00:00, confidence not recorded.
  - readme: https://github.com/facebookarchive/python-nubia (fetched 2026-08-28T04:05:06.064663+00:00, sha 0fc7c7dcc407)
- Data as of 2026-08-30T08:39:29.467469+00:00.