vacant — domain availability via authoritative DNS

Python bindings for the vacant Rust engine. Asks the authoritative TLD nameservers directly instead of WHOIS — fast, no rate limits, no waiting.

The wheel ships the same Rust engine compiled in, with a small Python facade and a vacant CLI entry point. Lockstep-versioned with the vacant crate: vacant 0.3.x (Python) wraps vacant 0.3.x (Rust) exactly.

Prefer a browser? vacant.alltuner.com is a hosted web UI built on vacant — a separate app that uses this package, not something it installs.

Install

Pick the path that matches how you'll use it:

CLI

brew install alltuner/tap/vacant   # macOS, Linux — native Rust binary
cargo install vacant               # any platform with a Rust toolchain
uvx vacant google.com              # one-shot, no install (Python wheel)

The brew / cargo paths give you the native Rust binary (instant startup, ideal for daily use). uvx runs the Python wheel — convenient when you don't want to install anything, slightly slower to start because it boots a Python interpreter.

MCP server

Expose vacant to AI agents over the Model Context Protocol (stdio). Needs the mcp extra:

uvx --from 'vacant[mcp]' vacant mcp

It registers one tool — check_domains(domains, verify=false) — returning a {domain, status} per input. Point any MCP client at it:

{ "mcpServers": { "vacant": { "command": "uvx", "args": ["--from", "vacant[mcp]", "vacant", "mcp"] } } }

Library

pip install vacant
# or with uv:
uv add vacant

from vacant import check_many, Status

results = check_many(["example.com", "anthropic.com", "totally-made-up-zxqv.cat"])
for r in results:
    print(r.domain, r.status.value, r.detail)

The on-disk SQLite cache is shared with the Rust CLI — runs against the same ~/.cache/vacant/results.db, so the brew binary and a Python script see each other's results.

from vacant import DiskCache, check_many

cache = DiskCache()  # default ~/.cache/vacant/results.db
results = check_many(["example.com"], cache=cache)

How it works

vacant.check_many calls into the Rust engine via PyO3 (vacant._core). The engine:

Normalizes the input.
Looks up cache; returns hits immediately.
Runs a per-zone precheck (length, charset, reserved labels) from the bundled rules.toml.
For inputs that pass, asks the parent zone's NS directly. Delegation → registered; NXDOMAIN/NODATA → unconfirmed (not delegated, not verified). Pass verify=True to confirm unconfirmed names against the registry's RDAP endpoint, promoting them to available (404) or registered (200, e.g. a held domain). available only ever means RDAP-confirmed.

available is not a registrability guarantee, though: new gTLD registries (especially community/city zones like .barcelona, .cat, .amsterdam, .berlin) keep reservation and premium lists invisible to DNS, WHOIS, and RDAP, so a name can read available yet still be refused at checkout (e.g. radio.barcelona). Tracked for an in-engine fix in #26.

Cache shape, rules format, and verdict semantics are all the engine's — see alltuner/vacant for the source of truth.

Develop

The Python package lives in the alltuner/vacant monorepo alongside the Rust engine, so dev commands run from the repo root:

just                 # menu
just py-develop      # build the maturin extension into the local venv
just py-check        # ruff + pytest
just py-wheel        # build a release wheel locally

License

MIT — see ../LICENSE.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vacant-0.4.12.tar.gz (129.4 kB view details)

Uploaded Jul 28, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

vacant-0.4.12-cp311-abi3-manylinux_2_28_x86_64.whl (5.1 MB view details)

Uploaded Jul 28, 2026 CPython 3.11+manylinux: glibc 2.28+ x86-64

vacant-0.4.12-cp311-abi3-manylinux_2_28_aarch64.whl (5.0 MB view details)

Uploaded Jul 28, 2026 CPython 3.11+manylinux: glibc 2.28+ ARM64

vacant-0.4.12-cp311-abi3-macosx_11_0_arm64.whl (4.5 MB view details)

Uploaded Jul 28, 2026 CPython 3.11+macOS 11.0+ ARM64

vacant-0.4.12-cp311-abi3-macosx_10_12_x86_64.whl (4.7 MB view details)

Uploaded Jul 28, 2026 CPython 3.11+macOS 10.12+ x86-64

File details

Details for the file vacant-0.4.12.tar.gz.

File metadata

Download URL: vacant-0.4.12.tar.gz
Upload date: Jul 28, 2026
Size: 129.4 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for vacant-0.4.12.tar.gz
Algorithm	Hash digest
SHA256	`a69ae5f5eecb9f525fa629aee06d83063a3d16156e69a4637eabb5f36abc428f`
MD5	`b2c88fe47200a0b8ff3b1cd19045427d`
BLAKE2b-256	`b27d029abda07ac4f26d5d6493a572b5d00a57f52c95791887eb5ec53d22b6b6`

See more details on using hashes here.

Provenance

The following attestation bundles were made for vacant-0.4.12.tar.gz:

Publisher: release.yml on alltuner/vacant

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: vacant-0.4.12.tar.gz
- Subject digest: a69ae5f5eecb9f525fa629aee06d83063a3d16156e69a4637eabb5f36abc428f
- Sigstore transparency entry: 2270901628
- Sigstore integration time: Jul 28, 2026
Source repository:
- Permalink: alltuner/vacant@e1a87cf81b96f922bfb8b86840cd3baf5a77a432
- Branch / Tag: refs/heads/main
- Owner: https://github.com/alltuner
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@e1a87cf81b96f922bfb8b86840cd3baf5a77a432
- Trigger Event: push

File details

Details for the file vacant-0.4.12-cp311-abi3-manylinux_2_28_x86_64.whl.

File metadata

Download URL: vacant-0.4.12-cp311-abi3-manylinux_2_28_x86_64.whl
Upload date: Jul 28, 2026
Size: 5.1 MB
Tags: CPython 3.11+, manylinux: glibc 2.28+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for vacant-0.4.12-cp311-abi3-manylinux_2_28_x86_64.whl
Algorithm	Hash digest
SHA256	`147ed05f95fd7db9f5345ffce7f4637a0d35673e506c43b71e687f26c00ad600`
MD5	`553473daffc6a5b791fd258b9711b6f7`
BLAKE2b-256	`e2e4874206ba125d29022861d051a705b7b367ad10eee3234acfeef4bcb38056`

See more details on using hashes here.

Provenance

The following attestation bundles were made for vacant-0.4.12-cp311-abi3-manylinux_2_28_x86_64.whl:

Publisher: release.yml on alltuner/vacant

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: vacant-0.4.12-cp311-abi3-manylinux_2_28_x86_64.whl
- Subject digest: 147ed05f95fd7db9f5345ffce7f4637a0d35673e506c43b71e687f26c00ad600
- Sigstore transparency entry: 2270901878
- Sigstore integration time: Jul 28, 2026
Source repository:
- Permalink: alltuner/vacant@e1a87cf81b96f922bfb8b86840cd3baf5a77a432
- Branch / Tag: refs/heads/main
- Owner: https://github.com/alltuner
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@e1a87cf81b96f922bfb8b86840cd3baf5a77a432
- Trigger Event: push

File details

Details for the file vacant-0.4.12-cp311-abi3-manylinux_2_28_aarch64.whl.

File metadata

Download URL: vacant-0.4.12-cp311-abi3-manylinux_2_28_aarch64.whl
Upload date: Jul 28, 2026
Size: 5.0 MB
Tags: CPython 3.11+, manylinux: glibc 2.28+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for vacant-0.4.12-cp311-abi3-manylinux_2_28_aarch64.whl
Algorithm	Hash digest
SHA256	`13f2f3d2f639ea6aad64013a7d38977a254d05c4d4abe0c2d26521987bb74ab1`
MD5	`206614cd136ac2d64e9050054502e4c1`
BLAKE2b-256	`a7cf266c2c3c15feee0fccfa99671add6792e8cfb748947558eb00ae32319cd8`

See more details on using hashes here.

Provenance

The following attestation bundles were made for vacant-0.4.12-cp311-abi3-manylinux_2_28_aarch64.whl:

Publisher: release.yml on alltuner/vacant

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: vacant-0.4.12-cp311-abi3-manylinux_2_28_aarch64.whl
- Subject digest: 13f2f3d2f639ea6aad64013a7d38977a254d05c4d4abe0c2d26521987bb74ab1
- Sigstore transparency entry: 2270902397
- Sigstore integration time: Jul 28, 2026
Source repository:
- Permalink: alltuner/vacant@e1a87cf81b96f922bfb8b86840cd3baf5a77a432
- Branch / Tag: refs/heads/main
- Owner: https://github.com/alltuner
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@e1a87cf81b96f922bfb8b86840cd3baf5a77a432
- Trigger Event: push

File details

Details for the file vacant-0.4.12-cp311-abi3-macosx_11_0_arm64.whl.

File metadata

Download URL: vacant-0.4.12-cp311-abi3-macosx_11_0_arm64.whl
Upload date: Jul 28, 2026
Size: 4.5 MB
Tags: CPython 3.11+, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for vacant-0.4.12-cp311-abi3-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`bce15221e2d1fea3d410b50159069f2e799c2c8e23beccf9eb554e419de1c547`
MD5	`5ea3692019f67669c3aa806226b02406`
BLAKE2b-256	`92c2fbc02f76ee29b4378db318668f978ed8f71ea0c3cec7819ba2a933dff6f7`

See more details on using hashes here.

Provenance

The following attestation bundles were made for vacant-0.4.12-cp311-abi3-macosx_11_0_arm64.whl:

Publisher: release.yml on alltuner/vacant

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: vacant-0.4.12-cp311-abi3-macosx_11_0_arm64.whl
- Subject digest: bce15221e2d1fea3d410b50159069f2e799c2c8e23beccf9eb554e419de1c547
- Sigstore transparency entry: 2270902176
- Sigstore integration time: Jul 28, 2026
Source repository:
- Permalink: alltuner/vacant@e1a87cf81b96f922bfb8b86840cd3baf5a77a432
- Branch / Tag: refs/heads/main
- Owner: https://github.com/alltuner
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@e1a87cf81b96f922bfb8b86840cd3baf5a77a432
- Trigger Event: push

File details

Details for the file vacant-0.4.12-cp311-abi3-macosx_10_12_x86_64.whl.

File metadata

Download URL: vacant-0.4.12-cp311-abi3-macosx_10_12_x86_64.whl
Upload date: Jul 28, 2026
Size: 4.7 MB
Tags: CPython 3.11+, macOS 10.12+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for vacant-0.4.12-cp311-abi3-macosx_10_12_x86_64.whl
Algorithm	Hash digest
SHA256	`f7da03de6c761f60eed6051a8a2078390270f8f669a0a37ed18ec7befb4b4dac`
MD5	`406eb41f69e71daf101b48f28d99c644`
BLAKE2b-256	`5f97077108c74b407f7a59c983f8de2134ad346253182da7e65e0c82964ffa0f`

See more details on using hashes here.

Provenance

The following attestation bundles were made for vacant-0.4.12-cp311-abi3-macosx_10_12_x86_64.whl:

Publisher: release.yml on alltuner/vacant

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: vacant-0.4.12-cp311-abi3-macosx_10_12_x86_64.whl
- Subject digest: f7da03de6c761f60eed6051a8a2078390270f8f669a0a37ed18ec7befb4b4dac
- Sigstore transparency entry: 2270902585
- Sigstore integration time: Jul 28, 2026
Source repository:
- Permalink: alltuner/vacant@e1a87cf81b96f922bfb8b86840cd3baf5a77a432
- Branch / Tag: refs/heads/main
- Owner: https://github.com/alltuner
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@e1a87cf81b96f922bfb8b86840cd3baf5a77a432
- Trigger Event: push

Release history Release notifications | RSS feed

0.4.15

Jul 29, 2026

0.4.14

Jul 29, 2026

0.4.13

Jul 29, 2026

This release

0.4.12

Jul 28, 2026

0.4.11

Jun 15, 2026

0.4.8

Jun 9, 2026

0.4.7

Jun 9, 2026

0.4.6

Jun 9, 2026

0.4.5

May 29, 2026

0.4.4

May 28, 2026

0.4.3

May 13, 2026

0.4.2

May 4, 2026

0.4.1

May 4, 2026

0.4.0

May 3, 2026

0.3.6

May 3, 2026

0.0.1

May 3, 2026

vacant 0.4.12

vacant — domain availability via authoritative DNS

Install

CLI

MCP server

Library

How it works

Develop

License

Project links

Key dates

1 maintainer

Credits

GitHub Statistics

License

Requires

Provides Extra

Tags

Classifiers

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

Release history Release notifications | RSS feed