nmavail 0.4.2

A powerful CLI tool to check name availability across domains and platforms

Nmavail

Nmavail is a powerful command-line tool designed to check the availability of names across multiple domains and platforms. Whether you are naming a startup, a new project, or an open-source library, Nmavail helps you secure your brand identity by verifying if a name is already taken.

Features

• Domain Availability: Checks popular TLDs (e.g., .com, .io, .dev, .ai) via WHOIS and DNS lookups
• Developer Platforms: Verifies username availability on GitHub and GitLab
• Package Registries: Checks if a name is available on PyPI, NPM, Crates.io, and Go Modules
• System Packages: Checks Homebrew, AUR, Debian/Ubuntu, and Alpine Linux
• Asynchronous & Fast: Uses async I/O to perform checks in parallel (~13 seconds total)
• Clean CLI Interface: Provides a beautiful, easy-to-read terminal output with smooth loading animations
• No Configuration Required: Works out of the box, no tokens or setup needed

Installation

Option 1: Install via uv (Recommended)

The easiest and recommended way to install Nmavail is using uv:

# Install uv (if not already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install nmavail (uv will automatically manage Python environment)
uv tool install nmavail

# Verify installation
nmavail --version

Option 2: Install via pipx

Alternatively, you can use pipx:

# Install pipx (if not already installed)
pip install pipx

# Install nmavail (pipx will create an isolated environment)
pipx install nmavail

# Verify installation
nmavail --version

Option 3: Run without installation

Try Nmavail without installing:

uvx nmavail test

Option 4: Install from Source

For developers or those who want the latest unreleased features:

git clone https://github.com/nmavail/nmavail.git
cd nmavail
uv sync  # or: pip install -e .
uv run nmavail test

Usage

Check Name Availability

To check a name across all supported platforms:

nmavail my-awesome-name

Example Output:

Package Registries:                                         
    ✗   PyPI                : Taken
    ✗   NPM                 : Taken
    ✓   Crates.io           : Available
    ✓   Go Modules          : Available

System Packages:                                            
    ✓   Homebrew            : Available
    ✓   Arch (AUR)          : Available
    ✓   Debian/Ubuntu       : Available
    ✓   Alpine Linux        : Available

Developer Platforms:                                        
  - GitHub:
    ✗   User/Org            : Taken
    ✗   Total Repos         : 9702854
    ✗   Top Stars           : 25920 stars
  - GitLab (list first 100 results only):
    ✗   User/Group          : Taken
    ✗   Total Repos         : 100+
    ✗   Top Stars           : more than 0 stars

Domains:                                                    
    ✗   my-awesome-name.com : Taken
    ✓   my-awesome-name.io  : Available
    ✓   my-awesome-name.dev : Available

Command Line Options

Show Version:

nmavail --version
nmavail -V

Show Help:

nmavail --help
nmavail -H

Examples:

nmavail test
nmavail google
nmavail myproject

Supported Platforms

Category	Platforms
Domains	.com, .org, .net, .io, .co, .dev, .app, .xyz, .ai, .me, .cn, .tv, .ly, .it
Developer Platforms	GitHub (User/Org & Repo Search), GitLab (User/Group & Repo Search)
Package Registries	PyPI, NPM, Crates.io, Go Modules
System Packages	Homebrew, Arch (AUR), Debian/Ubuntu, Alpine Linux

Performance

• Total check time: ~13 seconds (varies based on network conditions)
• Parallel execution: All checks run concurrently
• Smart pagination: GitLab limited to 1 page (100 results) for speed
• Optimized timeouts: 10 second timeout per request

Development

This project uses Ruff for linting and formatting.

# Format code
uv run ruff format .

# Lint code
uv run ruff check .

License

MIT